geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Lin Sun" <linsun....@gmail.com>
Subject Re: Documentation of new 2.2 features in current wiki?
Date Wed, 20 Aug 2008 21:35:00 GMT
I wish there is a way to tag a document page and say that it applies
to whatever release(s), then we can generate user docs for a release
based on documents that are tagged for that release.  It seems
reasonable for certain document pages to stay the same between
multiple releases.

Lin

On Wed, Aug 20, 2008 at 5:27 PM, Joe Bohn <joe.bohn@earthlink.net> wrote:
> Lin Sun wrote:
>>
>> I am concerned at making changes in two places and we should eliminate
>> that if possible.   Should we only copy the documents that are
>> complete?   Is the check mark next to the document link a good
>> indication of completeness?
>
> I agree with the concern (in fact I raised it myself yesterday) ... but it
> seems that the time is right to start the 2.2 doc.  We have people willing
> to jump in and help out with a new structure (like Rebekah and Jack) that
> were currently stuck and people were also interested in documenting 2.2
> functions.  It was agreed that seeding the 2.2 doc from the 2.1 space was
> the right approach.  Unfortunately, the export/restore is an "all or
> nothing" proposition.  You either copy the entire space or manually copy
> each individual page.  I have no idea if the checkmarks are accurate ... but
> I suspect they are not.
>
> As far as maintaining the 2 docs, I think we all should take the following
> approach:
> - Treat the 2.2 documentation as the "primary" documentation.  In other
> words, update this first if there are changes to be made.
> - Mirror updates from the 2.2 doc back to the 2.1 doc.
>
> That way, if there is any discrepancy we will know that the 2.2 doc is "more
> correct" and the things just might not have been mirrored back to 2.1 (or
> perhaps changed in 2.2).
>
> Joe
>
>
>>
>> Lin
>>
>> On Wed, Aug 20, 2008 at 4:39 PM, Joe Bohn <joe.bohn@earthlink.net> wrote:
>>
>>> Everyone,
>>> Now that we have 2 spaces we will need to mirror appropriate updates in
>>> the
>>> 2.1 space into the 2.2 space.  Please help us keep the doc consistent
>>> where
>>> appropriate.  Also, feel free to update the new space with specifics for
>>> Geronimo 2.2 now that we have it.
>>>
>>
>>> Thanks,
>>> Joe
>>
>
>

Mime
View raw message