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@allresnet.com Reply-To: The general-purpose Squeak developers listsqueak-dev@lists.squeakfoundation.org To: "'The general-purpose Squeak developers list'"squeak-dev@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_hmemailtaglineapr...