2 ms·
I don’t like having extra steps to convert things to more readable formats because it’s expensive and boring and tends to get out of sync very quickly. If non-
by prepend 7y ago
I don’t like having extra steps to convert things to more readable formats because it’s expensive and boring and tends to get out of sync very quickly.
If non-tech people on a team need to understand, in detail, a technical process, I think it’s easier to teach them to read through a script than to pay a tech writer to document the script, all the time.
I’ve run into this problem with non-technical project managers who want to understand in detail. If this level of understanding is necessary then it’s possible to scan a source file to read comments.
Or generate documentation from source and dump it on a web server somewhere.
Although lately even non-technical people are able to read and edit markdown files on GitHub.