Re:Best Practices for Writing Solid Software Documentation
by robaczek333 on Tuesday September 05, 2023 @05:23AM
(#37389600)
The goal of any documentation is to help people. "Good" documentation is useful. "Bad" documentation confuses readers and might physically harm people or damage equipment.
Also, when writing documentation, consistency is quite important. Often this is resolved with something known as a style guide. Style guides might be formal or informal. I think that point 3 in this article mentions it quite well.
Also, when writing documentation, consistency is quite important. Often this is resolved with something known as a style guide. Style guides might be formal or informal. I think that point 3 in this article mentions it quite well.