i'll say this again so i can pin it:

if your software doesn't require a manual, it isn't software, and could be a regular document

if your software does real computational work that justifies its existence, it requires a manual

document. your. software.

@tindall How about we meet in the middle and leave faulty documentation? I think that sounds like a fair deal.

@tindall However - some say that if a first-time user needs to look up a manual to be able to figure out how to do stuff in your software - that means the UI design is not intuitive. But of course even if the user doesn't *need* to consult a manual to figure stuff out - that doesn't mean there shouldn't be one ready when he/she finally needs it.

Sign in to participate in the conversation

Cybrespace is an instance of Mastodon, a social network based on open web protocols and free, open-source software. It is decentralized like e-mail.