# docsp > Static documentation portals from Markdown and JSON ## Get started - [What docsp is](/docsp/guides/introduction.md): A static site generator for documentation portals that hold several projects, each with guides, an API reference, a changelog, versions and locales. - [Install](/docsp/guides/install.md): Add docsp and Astro to a repository and run the docsp command. - [A first site in 5 minutes](/docsp/guides/first-site.md): Create a portal with one project and one page, preview it and build it. - [Project layout](/docsp/guides/project-layout.md): Where site.json, project.json, pages, assets, release notes and OpenAPI files go. - [URL scheme](/docsp/guides/urls.md): How docsp builds page URLs from locale, project, version, section and file name. - [Commands](/docsp/guides/cli.md): docsp dev, build and check, with their options and exit codes. - [Deployment](/docsp/guides/deployment.md): Publish dist/ on any static host, with a Cloudflare Workers static assets example. ## Writing - [Frontmatter](/docsp/writing/frontmatter.md): The YAML fields at the top of a page, and what each one changes. - [Directives](/docsp/writing/directives.md): Callouts, steps, code tabs, cards, figures, FAQ, glossary and inline elements, each with its syntax and the result. - [Code blocks](/docsp/writing/code-blocks.md): Fenced code with highlighting, file names, tab labels and terminal sessions. - [Links and images](/docsp/writing/links-and-images.md): Link to other pages with relative Markdown paths and add images from the project folder. - [Release notes](/docsp/writing/changelog.md): Write one Markdown file per release and get a changelog page, a page per release and the portal releases table. ## Configuration - [Configuration overview](/docsp/configuration/overview.md): What goes in site.json and in project.json, organized by the task you want to do. - [Theming](/docsp/configuration/theming.md): Theme axes, the accent color and its contrast rule, logo, banner, footer and the theme.css escape hatch. - [Code themes](/docsp/configuration/code-themes.md): Pick the colors of code blocks for a project, fix their mode, and let readers choose their own. - [Versions and languages](/docsp/configuration/versions-and-languages.md): Keep docs for old releases, mark versions as deprecated, translate pages and fall back when a translation is missing. - [Configuration reference](/docsp/configuration/reference.md): Every field of site.json and project.json, with its type, default and meaning. ## Features - [API reference](/docsp/features/api-reference.md): Generate one page per operation from an OpenAPI 3.x file, with parameters, request samples and a response example. - [Symbol index](/docsp/features/symbols.md): Link code in the docs to the symbols a compiler resolved, from indexes your project's CI produces. - [Search](/docsp/features/search.md): The static search index docsp builds, what the dialog shows, and the settings that change it. - [LLM outputs](/docsp/features/llm.md): Markdown twins of every page, llms.txt per project and the Copy for LLM button. - [Accessibility](/docsp/features/accessibility.md): What docsp enforces at build time, what its test suite checks, and what stays your responsibility. - [CI checks](/docsp/features/ci-checks.md): The checks to run in the CI of a repository that holds docsp content, with a GitHub Actions example. ## Contributing - [Repository layout](/docsp/contributing/repository.md): Where the docsp code, the example site, this documentation site and the tests live, and how to work on them. - [Design tokens](/docsp/contributing/design-tokens.md): The token pipeline, the generated files and the lint that keeps raw values out of components. - [Tests and CI](/docsp/contributing/testing.md): Unit tests, end-to-end tests with axe, the visual comparison script and the CI sequence.