From: Alan Garrison Date: 2005-01-15T00:07:20+09:00 Subject: Re: Proliferation of web frameworks Francis Hwang wrote: > > All true. So instead of asking people to code less, we should probably > ask them to document more. > I think for some projects it's not a matter of documentation quantity but just a lack of a stated purpose. Someone can post "I wrote Package X and here's the API", but what this doesn't answer is "why". If someone wrote something to scratch an intellectual itch, that's perfectly fine, but if you have a goal in mind for a particular project, state it up front. As far as frameworks goes, perhaps there just needs to be clarification on: 1) I wrote X because... 2) (If applicable) X is modelled after application/framework Y 3) Right now X can do... 3) I want X to eventually be able to do x, y, z... Particularly #4, if this is stated up front, you'll likely get other people contributing code faster just because the roadmap is plainly laid out. If code is created only for the itch-of-the-moment, a package won't get very far. > Francis Hwang > http://fhwang.net/ > > -- Alan Garrison Cronosys, LLC Phone: 216-221-4600 ext 308