We at the Neos project would like to use discourse for as many of our commenting/discussion needs as possible. (We’re building it at discuss.neos.io – wow, Discourse is pretty dang fantastic!)
One guy is even starting a plugin for our Neos CMS to use Discourse as the commenting system on our website. After all, it’s easier team members to follow the conversations of they’re all going on in the same place.
But, documentation is my cup of tea. Comments in discourse and on the website are one thing, but I need something slightly different for the docs. I don’t like how the PHP manual has the comment thread at the end of the page, but some of those comments contain vital corrections to the docs (and other comments are downright dated!). I wish I had a way to let people comment on our docs with medium-style contextualized comments/notes. Those, like Google docs comments, are perfect for quick notes about typos, inaccuracies, and broken examples. They are perfect for rewording a sentence while reading the docs without having to stop, open up the right documentation file in our git repo and finally rewrite that sentence.
I don’t want yet another place for comments and feedback to get sucked into a black hole because no one is actively checking for those comments. So, I wonder if there’s a way to integrate discourse as the backend for the medium-style notes (using the js lib on github) in our docs? Perhaps a special sub category would somehow hold all of those comments until resolved/closed…
Please make my documentation system dreams come true… Help me see a way to make this work