3 ms·
> The problem is… …multifaceted from my experience. 1. At the org-level… - no standard doc tooling - no easy-to-remember URLs - no simple permalinks
by hm-nah 3y 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!