I would love a comment feature below the doc.rust-lang.org website. A place to share examples, informally suggest clarification and ask questions related to each page.
I don’t think this is very useful. The comment section must be moderated and quality checked. It has been a huge problem for the PHP community for a long time that the doc comment section had questionable or outdated advice.
IMHO Q&A content belongs to sites like stackoverflow nowadays.
Oh, I hate Stack overflow and never use it anymore due to the unhelpful, rule obsessed, judgemental culture of some fairly large percentage of members.
And I love the PHP comment section; they were extremely helpful when I started learning PHP almost 20 years ago. I am pretty sure they are the primary reason why I quit pursuing the .asp.
Bad and wrong advice is downvoted by community members; but I can’t count the number of times where I have found a comment that had already asked my question.
This is the first time I hear about the comments being a problem for the PHP community. Are you really sure that it has been a problem?
Yes, I was leading a couple of PHP teams back then and we constantly had to get developers to not copy code from there.
Things have improved since then, but I would still not like to turn our official docs into half a Q&A site with all the problems attached with it.
Don’t get me wrong, I have no problem with annotation systems or community input, but the docs are editorialised content and some kind of method of quality control must be found.
This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.