Re: About the Wiki
Steve Wagner <[email protected]> Mon, 14 Jul 2008 21:01:03 +0200
| Newsgroups | gmane.comp.windows.dotnet.nhibernate.devel |
|---|---|
| Message-ID | <[email protected]> |
Whats with this domain: http://www.nhibernate.net/ It seems it is not reserved and it perfectly fits all needs :-) I am also for a wiki based documentation and for a wiki based homepage (like mono it dose) too. Steve James Kovacs schrieb: > I agree with Pierre Henri. Having the wiki be an editable version of the > NHibernate docs would lower the bar for people contributing to the > documentation. This would be a good thing. A quick Google revealed > DocBookWiki, which is wiki software specifically designed to display and > edit DocBook online. Rather than bulk importing/exporting DocBook->HTML, > DocBookWiki does it on the fly and stores its content in DocBook format. > > http://doc-book.sourceforge.net/homepage/ > > It sounds promising, but I've only read the intro page and not actually > tried it out. > > Personally I think that: > > http://docs.nhibernate.org > > would be a lot easier to remember than: > > http://www.hibernate.org/hib_docs/nhibernate/1.2/reference/en/html_single/ > > IMHO I think docs.nhibernate.org <http://docs.nhibernate.org> makes more > sense than wiki.nhibernate.org <http://wiki.nhibernate.org>. Wiki is an > implementation detail. Docs describes what it is. > > James > -- > James Kovacs, B.Sc., M.Sc., MCSD, MCT > Microsoft MVP - C# Architecture > http://www.jameskovacs.com > [email protected] <mailto:[email protected]> > 403-397-3177 (mobile) > > On Fri, Jul 4, 2008 at 2:47 AM, Pierre Henri Kuaté <[email protected] > <mailto:[email protected]>> wrote: > > We had a wiki a while ago (Confluence IIRC), but after the merging > with hibernate.org <http://hibernate.org>, most of its articles > where integrated in the current documentation. > > There are basically two options to start using one again: > - (Continue to) use the current Hibernate wiki. Yes, there is one :) > But it doesn't contain much NHibernate material. > - Install our own wiki at either nhibernate.sourceforge.net > <http://nhibernate.sourceforge.net> or wiki.nhibernate.org > <http://wiki.nhibernate.org> (that's where the old one was). > As far as I am concerned each of these options have their pros and > cons: Using the Hibernate wiki would allow a better integration of > the documentation (one website with everything). Hosting the wiki > separately would allow choosing the software we want... > > One of the main action aside for hosting the wiki is putting some > content in it since an empty wiki can be quite intimidating. Also, > it seems that many would like to have the same documentation they > have in the reference in that wiki (so that they can quickly edit > it). This will also require some work to port the DocBook version to > the wiki and keep them in sync (ie: port the edits back to the > DocBook version). > > Something that could ease and speed up that process would be to have > a wiki that support import/export from/to DocBook. I quickly googled > it and it seems that there are a few tools that could be used... > > Pierre Henri. > > > --- On *Thu, 7/3/08, Jon Stelly /<[email protected] > <mailto:[email protected]>>/* wrote: > > From: Jon Stelly <[email protected] <mailto:[email protected]>> > Subject: Re: [NHibernate-development] Aligning with Hibernate > versioning > To: "the NHibernate development list" > <[email protected] > <mailto:[email protected]>> > Date: Thursday, July 3, 2008, 11:20 PM > > I'd like to second the wiki idea. I think API-level > documentation is great, and I wouldn't want to lose what's there > in that CHM file but a Wiki where we could better capture some > guidance, examples, etc... would go a long way to making > NHibernate easier to learn for beginners. I've also had the > same thought "I'd like to expand on this description a bit" but > I don't have the motivation to download source and submit a > patch (call me lazy). > > On Wed, Jul 2, 2008 at 8:56 PM, Fabio Maulo > <[email protected] <mailto:[email protected]>> wrote: > > 2008/7/2 Will Shaver <[email protected] > <mailto:[email protected]>>: > > What we need is an actual Wikipedia style Wiki for docs. > There have been multiple times while reading the > documentation that I've thought, "that's wrong, and I > would fix it right here if I could... but firing up an > xml editor and re-compiling it is too much effort." > > > > Ok you and the community will have it ;) > > ------------------------------------------------------------------------- > Sponsored by: SourceForge.net Community Choice Awards: VOTE NOW! > Studies have shown that voting for your favorite open source > project, > along with a healthy diet, reduces your potential for > chronic lameness > and boredom. Vote Now at > http://www.sourceforge.net/community/cca08 > _______________________________________________ > Nhibernate-development mailing list > [email protected] > <mailto:[email protected]> > https://lists.sourceforge.net/lists/listinfo/nhibernate-development > > > ------------------------------------------------------------------------- > Sponsored by: SourceForge.net Community Choice Awards: VOTE NOW! > Studies have shown that voting for your favorite open source project, > > along with a healthy diet, reduces your potential for chronic lameness > and boredom. Vote Now at http://www.sourceforge.net/community/cca08 > > _______________________________________________ > Nhibernate-development mailing list > [email protected] <mailto:[email protected]> > https://lists.sourceforge.net/lists/listinfo/nhibernate-development > > > > ------------------------------------------------------------------------- > Sponsored by: SourceForge.net Community Choice Awards: VOTE NOW! > Studies have shown that voting for your favorite open source project, > along with a healthy diet, reduces your potential for chronic lameness > and boredom. Vote Now at http://www.sourceforge.net/community/cca08 > _______________________________________________ > Nhibernate-development mailing list > [email protected] > <mailto:[email protected]> > https://lists.sourceforge.net/lists/listinfo/nhibernate-development > > > > ------------------------------------------------------------------------ > > ------------------------------------------------------------------------- > Sponsored by: SourceForge.net Community Choice Awards: VOTE NOW! > Studies have shown that voting for your favorite open source project, > along with a healthy diet, reduces your potential for chronic lameness > and boredom. Vote Now at http://www.sourceforge.net/community/cca08 > > > ------------------------------------------------------------------------ > > _______________________________________________ > Nhibernate-development mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/nhibernate-development ------------------------------------------------------------------------- Sponsored by: SourceForge.net Community Choice Awards: VOTE NOW! Studies have shown that voting for your favorite open source project, along with a healthy diet, reduces your potential for chronic lameness and boredom. Vote Now at http://www.sourceforge.net/community/cca08