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

Reply via email to