Improving Discourse documentation

As developer/user communities go, discourse is well above average. Errors seem to be corrected quickly, feature requests aren’t just ignored, especially if there’s a reasonable use-case for them, and the online staff (paid or volunteers, I’m not sure how you tell who’s what) are pretty good and fairly patient at coaching us newbies along.

Yeah, the documentation needs work, but writing good documentation is expensive and time-consuming. Moreover, developers often don’t write good documentation because they’re just too close to the product, they don’t see it as users see it. Being too close to the code is also a product testing issue, though in many open source projects the user community does a good job testing things.

5 Likes