Columns

Documentation & Knowledge

Making documents a collaboration interface and knowledge bases findable and maintainable.

  1. Chapter 1

    Documents Are Not Records, but Collaboration Interfaces

    A practical way to write technical documents: state the conclusion and problem clearly first, then use the right structure to carry the plan, progress, and details.

  2. Chapter 2

    Why Technical Knowledge Bases Need Entry Pages

    An entry page is not a pile of links, but the shared memory a constantly changing project leaves for its team: it helps readers enter by task, judge whether information is still valid, and find the people responsible for maintaining it.

  3. Chapter 3

    Turning Spoken Ideas into Decision-Ready Documents

    Distill scattered thoughts into a document that can be discussed and acted on: tools handle the organizing, people handle the judgment.