RE: New Doc space

From: Gentry, Michael \(Contractor\) ("Gentry,)
Date: Tue Feb 07 2006 - 15:33:06 EST

  • Next message: Andrus Adamchik: "Re: New Doc space"

    Should we have "Cayenne 1.1" and "Cayenne 1.2" top-level folders?

    -----Original Message-----
    From: Andrus Adamchik [mailto:andru..bjectstyle.org]
    Sent: Tuesday, February 07, 2006 3:30 PM
    To: cayenne-deve..bjectstyle.org
    Subject: New Doc space

    I just created a new CAYDOC space. It has the same permissions as CAY
    space.

    http://objectstyle.org/confluence/display/CAYDOC/Home

    Would anyone volunteer to convert our XML docs from CVS to Confluence
    format and load them in?

    There is already a Velocity template that converts XML to HTML under
    cayenne-other/xdocs/stylesheets/cayenne.vsl. I hope it can be tweaked
    to generate much simpler confluence markup.

    Andrus

    On Feb 7, 2006, at 2:44 PM, Cris Daniluk wrote:

    > On 2/7/06, Andrus Adamchik <andru..bjectstyle.org> wrote:
    >>
    >> On Feb 7, 2006, at 1:52 PM, Cris Daniluk wrote:
    >>
    >>> We talked about this a while ago, but it kind of fizzled out I
    >>> think... maybe its time to move the documentation into the wiki.
    >>> WebWork does it in a separate space and exports the space to HTML
    >>> for
    >>> each release, so that you have "versioned" documentation. I think it
    >>> would be worth considering starting a space in the wiki to do just
    >>> this.
    >>
    >> I am still entertaining this idea... How do they handle two branches
    >> of documentation? What if we have to do releases of say 1.2 and 2.0
    >> in parallel for some time. I guess once a stable release is branched,
    >> we can copy the entire space to a separate "branch" space, and keep
    >> the main doc space up to date with HEAD?
    >>
    > I think copying the space would be the way to go. There's page level
    > versioning, but no space-level tagging/branching that would allow us
    > to concurrently manage the documentation in the same space. Copying is
    > pretty simple though, and major releases don't happen often.
    >



    This archive was generated by hypermail 2.0.0 : Tue Feb 07 2006 - 15:33:08 EST