Writing it down

Writing it down

Pages nobody reads are worse than no pages, because they look like coverage.
  • Write for the person who has to do the thing, not for the person who already knows.
  • Cut everything that isn't load-bearing. Say what is true in the fewest words that stay accurate.
  • Link out rather than explaining a tool that someone else documents better.
  • Plain headings and plain paragraphs. Formatting is not clarity.
  • Put the why next to the what. One sentence.
If you want to go further, write your knowledge as patterns: a short article per topic that states the situation, what to do, and where organizations reasonably differ. Patterns are easier to keep current than a handbook, because each one can be fixed on its own.
You are welcome to base yours on ours. Say on the page that it came from a Moral Fabric pattern, and put a date on it for when to check whether ours has changed.

Your variation

Handbook or patterns, either works. Note which you picked.