Skip to content

Adding or Changing Content

Owner: Martyn · Last reviewed: 29 September 2026 · Status: Live

  1. Agree the change with the portal owner (for new pages or bigger changes).
  2. Make the change as a pull request against this repository, or against the touchstone for Pricing. Follow the page standards.
  3. Fill in the pull request template. The title follows the Conventional Commit format (for example docs(pipeline): add the ICP page), because it becomes the commit message on main.
  4. Davs reviews and approves it. Every pull request needs his approval, the portal owner's included; nobody merges their own without it.
  5. Once approved, it is merged into main. The site rebuilds automatically.
  6. Anything that changes a definition, target, or process other people depend on gets a line in the changelog.

A new page takes the next free number in its section and a line in the section README, which is the section's reading order. CI checks that every link resolves and that every page is listed in its section README.