Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| documentation [2024/08/29 00:08] – [culture] qlyoung | documentation [2024/08/29 00:16] (current) – qlyoung | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | I strongly appreciate excellent technical documentation. You can have a great piece of software but if it's difficult to understand how to use it, users will fail to appreciate it. | + | ====== documentation ====== |
| + | |||
| + | I strongly appreciate excellent technical documentation. You can have a great piece of software but if it's difficult to understand how to use it, at best users will fail to appreciate it and at worst huge amounts of time will be wasted and vast quantities of errors committed. | ||
| Because I appreciate good documentation for tools I use I do my best to write useful documentation. In addition to the obvious benefit, which is that good documentation saves everyone time, I find there are several additional benefits specific to the act of writing documentation: | Because I appreciate good documentation for tools I use I do my best to write useful documentation. In addition to the obvious benefit, which is that good documentation saves everyone time, I find there are several additional benefits specific to the act of writing documentation: | ||
| Line 70: | Line 72: | ||
| - KP realizes there are no docs. KP spends 2 minutes creating a docs page, writes down the answer, gives it to the user. | - KP realizes there are no docs. KP spends 2 minutes creating a docs page, writes down the answer, gives it to the user. | ||
| - | Now the user has that docs page to share with anyone facing the same problem and KP can spend less time answering that question in the future | + | Now the user has that docs page to share with anyone facing the same problem and KP can spend less time answering that question in the future. This saves everybody time and improves morale. |
| ===== docs pitfalls ===== | ===== docs pitfalls ===== | ||
documentation.1724890115.txt.gz · Last modified: 2024/08/29 00:08 by qlyoung
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International