|
|
|
|
|
|
by larsrc
604 days ago
|
|
|
"[docs] will take an example and do something with it to demonstrate an outcome." No. Good docs will explain the context and choices made and trade-offs and risks and relations etc. All the things you can't read from the code. API docs can to a great degree be auto-generated, but not writing the _why_ is the beginning of the end. |
|
|