Art Delano is a user on octodon.social. You can follow them or interact with them if you have an account anywhere in the fediverse. If you don't, you can sign up here.
Art Delano @ardgedee

If the first question in your FAQ for your project is not "What is [your project]?" it's not a FAQ.

· Web · 0 · 0

And when your project's FAQ has the question "What is [your project]?" the answer has to be truthful, have a reasonable level of abstraction and ideally be ELI5-level. Leveraging it as an opportunity for snark means you're an asshole.

@ardgedee happened with an in-house project. Email sent around exhorting people to see [wiki] and provide feedback. Said wiki had nothing to describe project. Turns out they’d renamed the project and not carried over some key parts of the doco.

@waider Experienced that many times... when the org has written docs. Usually it's worse: Essential documentation is still assumed to be safest stored in SMEs' heads.

On the upside, within a closed org there is at least an authority reference, albeit in the form of a person available to be bothered.

On the downside: Vacations and layoffs.