On 08/31/2012 08:31 AM, Andrew Faulds wrote: > On 31/08/12 08:50, Adam Harvey wrote: >> 2. Kill user notes completely. The new site design (I'm getting to >> that in another e-mail in the not-too-distant future, hopefully) has >> more prominent links for reporting bugs and going to the online >> editor, so I'm hopeful that we might actually get the useful feedback >> listed above via those means instead, and can then incorporate them >> into the manual proper. > This is what I'd like. I don't think we should have comments in a > *manual*. They usually aren't helpful. If something's missing from docs, > it should be added to them, not commented.
I think that is a terrible idea. Yes there is some junk in there, but there are also a lot of useful stuff and it is something most users love. With a bit more attention from people we can improve the quality and I think that could start with a better UI and a bit of cheer leading from me and other PHP devs to motivate more people to help out. Maybe I should push the internals posts to useful contribution ratio harder, or we could tie wiki voting to a minimum contribution level. Editing notes, handling bug reports, doc commits, code commits, etc. Not that I really want to build an accounting system for that, but just try to get it into peoples' minds that they need to balance their ranting on internals with some positive contributions. -Rasmus
