On Sun, Jul 18, 2004 at 10:14:23PM +0200, Peter Eisentraut wrote: > David Fetter wrote: > > It's been pointed out to me that I tend to document by example > > Documenting by example is like proving by example -- it helps > understanding, but it doesn't replace the actual thing. > Nonetheless, no one ever claimed that more examples would be a bad > thing.
I see I have gotten off to a bad start here, and I apologize for not having made myself clearer. I did not suggest removing the "principles" items from the docs, nor did I suggest that anybody thought examples are a bad thing. What I am looking for is how the community feels about committing resources, which are in short supply, to putting more examples in the docs. I think this is a worthwhile effort, as it can pull in a larger group of people to do documentation, taking some load off people who do coding. :) Cheers, D -- David Fetter [EMAIL PROTECTED] http://fetter.org/ phone: +1 510 893 6100 mobile: +1 415 235 3778 Remember to vote! ---------------------------(end of broadcast)--------------------------- TIP 7: don't forget to increase your free space map settings
