I was imagining per method/section would be best. The php docs
illustrate this well. Even if you abandon shoes and the docs are crap,
people still get to add extra information about bugs and cool hacks
and stuff on the comments of methods.
I suppose if you wanted you could even have both though... then people
could conceptually comment even on the intro paragraphs on a page. :)
I still think it'd be really awesome to have a wikish thing for
camping wiki kinds of contributions though, as a simple repository for
random junk. People could put up funky widgets and tutorials and stuff
like that. One of my favorite aspects of camping was the fun stuff on
the wiki. :)
On 03/10/2008, at 3:35 PM, _why wrote:
On Fri, Oct 03, 2008 at 11:52:19AM +1000, Bluebie, Jenna wrote:
Another model which I really like is on each section in the manual,
have a
small 'comment' link.
Yes, people are more likely to leave comments than jump into writing
docs. If I did this, do you think comments should be per-paragraph
annotations or collected at the end of page?
_why