[Zope-dev] structuring the zopetoolkit SVN layout/web presence

Jim Fulton jim at zope.com
Tue Sep 15 04:21:21 EDT 2009


+1

Jim

On Tue, Sep 15, 2009 at 3:57 AM, Martijn Faassen <faassen at 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-Dev at 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


More information about the Zope-Dev mailing list