Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

> 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!


Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: