doctrine/docs-builder

Helper package for building the docs in Doctrine repos

1.0.3 2025-10-09 08:46 UTC

Requires

• phpdocumentor/filesystem: 1.7.1
• phpdocumentor/guides-cli: 1.7.1

Requires (Dev)

• ergebnis/composer-normalize: ^2.48

MIT

• Pauline Vos

README

A package for generating Doctrine repo docs in a unified way. Its purpose is to abstract the underlying method away from the generating command. It assumes:

• it's run from the project root, and
• the docs reside in docs/en/.

It uses phpdocumentor tooling for parsing the RST files.

This project is considered an internal tool and therefore, you shouldn't use this project in your application. This repository doesn't provide any support, and doesn't guarantee backward compatibility. Any or the entire project can change, or even disappear, at any moment without prior notice.

Usage:

composer require --dev doctrine/docs-builder -d docs
./docs/vendor/bin/build-docs.sh [<output>]

The output directory defaults to docs/output.

Optionally, declare a script in your root composer.json for convenience:

"scripts": {
    "docs": "./docs/vendor/bin/build-docs.sh @additional_args"
}

Then run composer docs [<output>].