|
|
|
|
|
|
by hm-nah
901 days ago
|
|
|
> The problem is… …multifaceted from my experience. 1. At the org-level… - no standard doc tooling
- no easy-to-remember URLs
- no simple permalinks
- no easy-to-update “pages” (AKA markdown-based)
- they certainly don't train employees how to create good docs
- minimal if any doc standards
2. At the leadership-level… - they don’t incentivize good documentation
- they don’t set the expectation that “everybody writes”
- they don’t document themselves!
It’s no wonder docs are scattered, out of date and untrustworthy! |
|
|