Re: About the Wiki

I agree. Being able to consume/produce DocBook would be a huge time-saver
assuming it works as advertised. I don't have a problem with hosting on a
non-Windows platform*, though I do have somewhat of a preference for using a
tool based on .NET and NHibernate because I think dogfooding is a good
thing. That preference doesn't go so far as to try to port DocBookWiki to
.NET/NHibernate. I would rather be contributing to NHibernate than hacking
at a documentation tool.

* I spent many years hacking on various 'nixes. You know you're deep in the
kernel when printf doesn't work and you have to resort to puts. It was fun,
but I'm glad to be working higher in the stack these days...

James
--
James Kovacs, B.Sc., M.Sc., MCSD, MCT
Microsoft MVP - C# Architecture
http://www.jameskovacs.com
[email protected]
403-397-3177 (mobile)

On Mon, Jul 7, 2008 at 9:42 PM, Pierre Henri Kuaté <[email protected]> wrote:

> If we can't find an alternative running on Windows, we should still go for
> this option (and host it on nhibernate.sf.net for eg); it would be a huge
> time-saver...
>
>
> --- On *Tue, 7/8/08, James Kovacs <[email protected]>* wrote:
>
> From: James Kovacs <[email protected]>
> Subject: Re: [NHibernate-development] About the Wiki
> To: "the NHibernate development list" <
> [email protected]>
> Date: Tuesday, July 8, 2008, 5:29 AM
>
>
> I saw PHP and figured it could run on a Windows box. I didn't read farther
> to see the other dependencies. Too bad.
>
> James
> --
> James Kovacs, B.Sc., M.Sc., MCSD, MCT
> Microsoft MVP - C# Architecture
> http://www.jameskovacs.com
> [email protected]
> 403-397-3177 (mobile)
>
> On Sun, Jul 6, 2008 at 10:44 PM, Ayende Rahien <[email protected]> wrote:
>
>> Looks like a cool suggestion.
>> But it is running on Linux.
>>
>> On Fri, Jul 4, 2008 at 6:49 PM, James Kovacs <[email protected]>
>> wrote:
>>
>>> 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 makes more sense than
>>> 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]
>>> 403-397-3177 (mobile)
>>>
>>> On Fri, Jul 4, 2008 at 2:47 AM, Pierre Henri Kuaté <[email protected]>
>>> wrote:
>>>
>>>>  We had a wiki a while ago (Confluence IIRC), but after the merging with
>>>> 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 or
>>>> 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]>* wrote:
>>>>
>>>> From: Jon Stelly <[email protected]>
>>>> Subject: Re: [NHibernate-development] Aligning with Hibernate versioning
>>>> To: "the NHibernate development list" <
>>>> [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]>
>>>> wrote:
>>>>
>>>>> 2008/7/2 Will Shaver <[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]
>>>>> 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
>>>> _______________________________________________
>>>> 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
>>> _______________________________________________
>>> 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
>> _______________________________________________
>> 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
>
> _______________________________________________
> 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
> _______________________________________________
> 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

_______________________________________________
Nhibernate-development mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/nhibernate-development