Docs, releases & Notion

Updated 2026-08-28

Everything beyond the manifest is optional content that the platform discovers automatically.

Documentation

Drop markdown files in content/services/<slug>/docs/. Each file becomes a page in your service's Documentation dropdown.

index.md is your landing page.
Any other <page>.md becomes /services/<slug>/docs/<page>.
Frontmatter drives the sidebar; ## and ### headings build the "On this page" table of contents.

---
title: Getting started
order: 1
updated: 2026-08-28
---

Intro paragraph.

## A section

Content with **bold**, `code`, and lists.

Announcements

announcements.yaml powers the Announcements block at the top of your Overview — the fastest way to tell everyone what your team is shipping. Emojis encouraged. Each message is clamped to two lines in the console, so keep it punchy and the experience stays unified across every service.

announcements:
  - message: "🚀 Slots now boot ~40% faster — most previews are ready in under 3 min."
    author: Platform · Holodeck
    date: "2026-08-28"
    href: https://www.notion.so/abridge/Holodeck   # optional

Release notes

Add releases.yaml with a releases list. Missing → a clean "ready for ingest" state. The shape matches a future GitHub Releases ingest, so you can swap the source later without touching the UI.

source: local
releases:
  - version: 2026.07.06
    publishedAt: "2026-07-06"
    url: https://github.com/abridgeai/<repo>/releases
    summary: One-line summary of the release.
    sections:
      Added:
        - New thing you shipped. (#132)
      Fixed:
        - Bug you squashed. (#124)

Notion

Set notionHref in the manifest to link your team's external Notion space. A Notion tab appears in the console automatically.