Date classes
J J
azreal1977 at hotmail.com
Fri Apr 20 07:13:33 UTC 2007
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.
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.
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.
>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
More information about the Squeak-dev
mailing list
|