FAQ | Docouture

1. What is docouture?

A documentation platform: a themed Antora UI bundle, a set of Antora/https://asciidoctor.org[Asciidoctor] extensions, and the docouture CLI that scaffolds, serves, builds and publishes a site on top of them. See About.

2. Do I need to know Antora or AsciiDoc already?

Only the basics of AsciiDoc for writing pages — the CLI scaffolds everything else (playbook, component descriptor, navigation, workflows). See Quickstart.

3. How do I create a new site?

npx @inditextech/docouture-cli new <name> from an existing git repository. See Quickstart and CLI.

4. Can documentation be versioned?

Yes — standalone (a rolling stable tag alongside a prerelease) or versioned (every release its own immutable tag, kept forever). See Versioning modes.

5. Does it support diagrams?

Yes, via a self-hosted Kroki service: mermaid, plantuml, bpmn, excalidraw and more, enabled by default. See Integrations.

6. What about syntax highlighting?

Build-time, via Shiki — set with source-highlighter: shiki in the playbook, already the default a scaffolded site ships with.

7. Is search included?

Yes — a full-text search index is built at build time and read directly by the UI bundle’s own search dialog, no extra wiring required.

8. How do I publish the site?

docouture publish gh-pages, or the GitHub workflows docouture new already scaffolds. See Publishing a documentation.

9. Can AI agents help write the docs?

Yes — npx skills@latest add InditexTech/docouture --all installs a set of agent skills that plan structure, draft content from the repo, and keep it in sync as the repo changes. See AI-First approach.

10. Is docouture open source?

Yes. The CLI, the Antora/Asciidoctor extensions and the release tooling are Apache-2.0; the UI bundle’s own fork of antora-ui-default mixes MPL-2.0 (files that are a Modification of an upstream file) with Apache-2.0 (files with no upstream counterpart), per its own LICENSE and NOTICE. Its design tokens, component CSS and icons (Lucide, ISC licensed) are all original or openly licensed, with nothing embedded that restricts publishing a site built with it.