On Jul 21, 2005, at 18:44 Uhr, Eelco Hillenius wrote:
>>i prefer a central well structured reference i can use. I also
learned that it is way >>better starting docs in early phaseand
postpone some features than having to write a
>>huge >doc later on.
I agree with you, but... not all programmers are good writers. I
had a go at it, but I find it very hard to write a good guide.
Absolutely. Me too. I hate to write docs, but I also hate having no
docs. So it's sort of a necessary evil. the ones I write are quite
tailored to my needs. so it's hard for people that where not involved
into decision making and programming process to understand what it
meant. I guess most programmers suffer from this.
Furthermore, working on Wicket is also about scratching my itch.
[...] Someone with a different skillset - a writer - should do the
manual. I hope Geertjan will continue to help us out here...
Yep, I agree. I writer should do this. I totally understand the docs
problem since I have it too ;) Support on the list is important, no
doubt. But having good docs answers many simple questions up-front
and Q's going to the list will become meaty and interesting and will
challenge the developer in us :D At least that was my experience with
OS.
l8er
-andi
-------------------------------------------------------
SF.Net email is sponsored by: Discover Easy Linux Migration Strategies
from IBM. Find simple to follow Roadmaps, straightforward articles,
informative Webcasts and more! Get everything you need to get up to
speed, fast. http://ads.osdn.com/?ad_id=7477&alloc_id=16492&op=click
_______________________________________________
Wicket-develop mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/wicket-develop
