All products

Build an engineering wiki in Notion with AI

Give engineers a dependable way to find the current runbook, distinguish it from a proposal and see which decisions the team has actually accepted.

Build an engineering wiki in Notion with AI around a question that has sent someone to the wrong page before. A well-written proposal for a new deployment method is a poor runbook if the team still uses the old method.

The notion-build-my-engineering-wiki workflow groups material by how engineers use it. Getting started, understanding an architectural choice and responding to an operational problem are different tasks. Each section can stay small until the team has useful material to put there.

What it does

  • Keep the current setup guide easy for a new starter to find.
  • Distinguish an accepted decision from an architectural proposal.
  • Group runbooks by the service they concern.
  • Show when a document is a draft and who maintains it.
  • Link an engineering project to its relevant technical references.

Install and use

  1. Provide representative documents and an authorised Notion destination for saving the wiki. A setup guide, an accepted decision and a runbook make a practical first set.
  2. Try: “Build a technical home from these notes. Mark the database proposal as unaccepted and keep the existing operating guide easy to reach.”
  3. Test the result using a real question. If the answer depends on the implementation, ask the team to verify which document describes it.

FAQ

Source

Made by Notion. Original skill: notion-build-my-engineering-wiki, published on GitHub under the MIT licence.

View on GitHub