2007/4/20, J J <azreal1977 at hotmail.com>:
> I think the problem we are seeing is that we don't really have a distinction
> between "stable" and "live branch" in Seaside right now.  I think what
> happens in most OS projects is when a branch moves to "stable" (i.e. no new
> features added to the branch, just bug fixes) then the documentation team
> can come in and make sure the documentation is 100% because the target isn't
> moving so much anymore.

stable: Seaside 2.7
live: Seaside 2.8

> The main Seaside branch is moving so fast documenting it would be a
> situation where; before you can publish the change set with the
> documentation, much of it is already invalid.

No

> I think we need to have a separate group doing the documentation if
> possible, these guys are on a role, we should let them keep at it.

We are happy for any help.

Cheers
Philippe

> >From: "Ramon Leon" <ramon.leon at allresnet.com>
> >Reply-To: The general-purpose Squeak developers
> >list<squeak-dev at lists.squeakfoundation.org>
> >To: "'The general-purpose Squeak developers
> >list'"<squeak-dev at lists.squeakfoundation.org>
> >Subject: RE: Date classes
> >Date: Tue, 17 Apr 2007 10:37:35 -0700
> >
> > > "But if it is not documented it may as well not exist" - so
> > > the features you mention that are so great actually for real
> > > purposes (apart from personal hacking) do not exist!
> >
> >Not true.  They've been doing lots of stuff lately to improve performance.
> >We all benefit from that whether they document it or not.
> >
> > > When you are working in a professional coding environment,
> > > anything without documentation falls below the radar.
> > > Management cant keep looking at source code to see if a
> > > needed feature has arrived.
> > >
> > > best regards
> > >
> > > Keith
> >
> >I don't see a professional coding environment, I see 3 or 4 guys
> >contributing their spare time writing one of the most kick ass web
> >frameworks ever made.  I see check in comments on every commit saying what
> >they did.  If there's a lack of comments in the code and on the classes, I
> >don't blame them, I blame us, for not jumping in and helping them out.
> >Would more comments be nice, sure, but lets not make the only guys doing
> >the
> >work feel bad about it.
> >
> >Ramon Leon
> >http://onsmalltalk.com
> >
> >
>
> _________________________________________________________________
> Exercise your brain! Try Flexicon.
> http://games.msn.com/en/flexicon/default.htm?icid=flexicon_hmemailtaglineapril07
>
>
>