[Grok-dev] Re: towards a release

David Bain david.bain at alteroo.com
Fri Mar 7 16:36:12 EST 2008


I think a gallery of grok sites (in production) would be good to have
for version 1.0, perhaps version 0.12 will be the version that will
bring new persons building out production sites.

On Fri, Mar 7, 2008 at 4:21 PM, Justin Fletcher <justin at opensoft.ws> wrote:
> That might work.  Are you able to specify multiple versions?
>
> -Justin
>
>
>
> On Fri, Mar 7, 2008 at 7:39 PM, Tim Knapp <duffyd at kokorice.org> wrote:
>
> > Hi Martijn/Justin et al,
> >
> > Just a thought, in previous version of PHC you could specify a relevant
> > Plone version that the document applies to (hopefully this feature is
> > still there). Couldn't we just repurpose this feature for Grok?
> >
> > HTH,
> > Tim
> >
> >
> >
> >
> > On Fri, 2008-03-07 at 17:49 +0100, Martijn Faassen wrote:
> > > Hey Justin,
> > >
> > > Thanks for your comment on the documentation, I think that's a valuable
> > > point.
> > >
> > > We need to see how to organize the website to do this. I'm looking at
> > > Kevin Teague now for advice on whether plone help center would allow
> > > such a thing.
> > >
> > > The way we could work is to have the documentation in the present
> > > location always reflect the most recent release.
> > >
> > > Then, as we make a release, we copy all that documentation into its own
> > > section named after the release. The hardest part will be to fix up all
> > > the internally pointing URLs to be consistent...
> > >
> > > This way, we could keep a record of the state of the documentation at
> > > release. We need to couple this with clear guidelines concerning the
> > > main flow of documentation: it should only contain documents relevant to
> > > the most recent release, and not anything that won't work anymore or not
> > > yet.
> > >
> > > There is a need to develop documentation ahead of time for a new
> > > release. This could be done in SVN trunk, or in some special area on the
> > > website. Upon release, *before* we shift the documentation off into its
> > > own section, we should integrate all this into the main section.
> > >
> > > There is enough to watch and work out here to need someone who shepherds
> > > this process. Without a plausible volunteer I don't think we have enough
> > > resources to afford this right now. Instead we should then just focus on
> > > maintaining the current set of documentation to be up to date.
> > >
> > > Regards,
> > >
> > > Martijn
> > >
> > > _______________________________________________
> > > Grok-dev mailing list
> > > Grok-dev at zope.org
> > > http://mail.zope.org/mailman/listinfo/grok-dev
> >
> > _______________________________________________
> > Grok-dev mailing list
> > Grok-dev at zope.org
> > http://mail.zope.org/mailman/listinfo/grok-dev
> >
>
>
> _______________________________________________
>  Grok-dev mailing list
>  Grok-dev at zope.org
>  http://mail.zope.org/mailman/listinfo/grok-dev
>
>


More information about the Grok-dev mailing list