Kinda related to my previous post about Matrix but it's unfortunately a much more widespread problem:

When people complain about the documentation quality, don't respond by telling them to fix it! This is a useless response.

Complaining about the docs means they probably don't understand them, and so they also cannot document it.

If you want a serious and successful documentation overhaul, you *as a developer* need to be involved in the process.

At the very least, you need to make yourself consistently available with quick response times to whoever is doing the documentation work.

You are likely the only one(s) who actually understand the undocumented details, and so it needs to be possible for people doing documentation work to retrieve that information from you as-needed.

· · Web · 0 · 3 · 4
Sign in to participate in the conversation
Pixietown

Small server part of the pixie.town infrastructure. Registration is closed.