Re: User notes

On Fri, Aug 31, 2012 at 8:50 AM, Adam Harvey <aharvey@php.net> wrote: > 1. No change. As things stand, the only people who seem to look > regularly at the new notes are Dan and myself, with a few others > (including Sherif, Nikita and Peter) cleaning out particular pages. If > you pick a reasonably commonly hit page and look at the user notes, I > don't think this approach is scaling. It isn't scaling, but we do have crapload of people with php.net karma, and all of them have the ability to edit/reject notes.. Most simply don't know it. I think we should try to reach out the individual extension maintainers and get them to review their own pages. > 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. I don't think removing them is a good idea. Newbies like to go to the manual and copy and paste snippets. > 3. Replace user notes with something more comment-based: either > something on-page like Disqus (which probably doesn't get us much > other than comment threading for better conversations and a shitty > UI), or linking to something like StackOverflow (maybe we see about > getting a PHP-specific, officially-blessed StackExchange, with links > from function references to tags?). How would outsourcing the problem to StackOverflow make it any better? The only advantage I see is the 'upvoting' - which shouldn't be all that hard to implement. The down side is an extra click, hard to find back your favorite copy&paste snippet, and reduced chances of us incorporating anything into the manual. -Hannes