# navigating-the-docs
URL: https://docs.awellhealth.com/skills/navigating-the-docs.md

> For the complete documentation index, see [llms.txt](https://docs.awellhealth.com/llms.txt).


# Navigating Awell Docs

A short guide for agents reading this site. You're here to find and use Awell documentation, not to
write it. This file describes *how to get around* — the map itself is [`/llms.txt`](/llms.txt).

> This is the only skill exposed to external agents on the deployed site. Authoring skills
> (terminology, voice, page structure) live in the repository for contributors and are not served
> here.

## The map

- `/llms.txt` — the concise index of every docs, API-reference, and changelog page. Start here.
- `/llms-full.txt` — all pages concatenated as clean Markdown, for agents that want everything in
  one fetch.

## Fetching a page as Markdown

Every `/docs/**` and `/api-reference/**` page is also served as clean Markdown at its URL with `.md`
appended. Prefer that over the HTML — same content, no presentation chrome.

- `/docs/extensions/what-are-awell-extensions` → `/docs/extensions/what-are-awell-extensions.md`
- `/api-reference/guides/authentication` → `/api-reference/guides/authentication.md`

The changelog is a single aggregate page; fetch it as `/changelog.md`.

The site is organized into a few top-level buckets — `/docs/**`, `/api-reference/**`, and `/changelog`. `/llms.txt` enumerates everything under those, so read it for the current tree, then fetch the page you need as `.md`.

## Terms

Awell uses specific canonical terms (e.g. **care flow**, not "pathway"). Prefer the terms you find
in the pages you fetch — they're authoritative. If you need the full glossary, it lives in the
repository at `skills/awell-terminology/SKILL.md` and is not served on this site.

## What's not here

Authoring skills (voice and tone, terminology glossary, page structure, changelog format) live in
the repo for contributors. You don't need them to read or answer questions about Awell.