Re: About the Wiki

"Ayende Rahien" <[email protected]> Tue, 8 Jul 2008 06:50:03 +0300
Newsgroups gmane.comp.windows.dotnet.nhibernate.devel
Message-ID <[email protected]>
Yes, agreed.
Anyone here is capable of setting up a linux solution? My skills are a
decade out of shape and were never that great to begin with

On Tue, Jul 8, 2008 at 6:42 AM, 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