+1 Jim
On Tue, Sep 15, 2009 at 3:57 AM, Martijn Faassen <faas...@startifact.com> wrote: > Hey, > > I think it would be good if we could (eventually) separate the Zope > Toolkit development documentation (what's published by > docs.zope.org/zopetoolkit now) from the Zope Toolkit release documentation. > > Zope Toolkit dev documentation: > > * aimed at people who need to *manage* the development of the ZTK. > > * talks about release policy, steering group, steering group decisions, etc. > > * in svn.zope.org/zopetoolkit-dev/trunk (right now in > svn.zope.org/zopetoolkit/doc) > > * we just continue to publish the trunk, tagging will be rare. > > * might be branched to propose larger restructuring > > * there's a link in there to individual Zope Toolkit releases, of course. > > * might be published under docs.zope.org/zopetoolkit/dev > > Zope Toolkit documentation: > > * in svn.zope.org/zopetoolkit/trunk > > * gets published to docs.zope.org/zopetoolkit/<release_nr> > > where docs.zope.org/zopetoolkit/current is the lastest release. > > and possibly docs.zope.org/zopetoolkit/trunk is the trunk. > > * aimed to developers who want to *use* (bits of) the ZTK. > > * contains also the locked down list of versions for the Zope toolkit > > * contains a bit about the ZTK, what it is for, the history up until > now. > > * there's of course a link to the dev documentation too. > > * contains *usage* documentation for the Zope Toolkit. Tells people a > bit about how the packages relate to each other. > > * contains upgrade notes about how to get from older version of ZTK to > this one. > > * also contains automatically generated information: > > * the list of packages (autogenerated now) > > * dependency diagram (use z3c.recipe.depgraph?) > > * aggregation of change logs? (I have some half-baked scripts that > might be useful - I think especially major releases contain > upgrade information that would be uesful, i.e. code that > moved to another package) > > Regards, > > Martijn > > _______________________________________________ > Zope-Dev maillist - zope-...@zope.org > https://mail.zope.org/mailman/listinfo/zope-dev > ** No cross posts or HTML encoding! ** > (Related lists - > https://mail.zope.org/mailman/listinfo/zope-announce > https://mail.zope.org/mailman/listinfo/zope ) > -- Jim Fulton _______________________________________________ Zope-Dev maillist - Zope-Dev@zope.org https://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - https://mail.zope.org/mailman/listinfo/zope-announce https://mail.zope.org/mailman/listinfo/zope )