---
title: "Developers"
manual: "Render guides"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3renderguides:developers"
source: "Developer/Index.rst"
rendered: "2026-09-19T06:16:43+00:00"
---

# Developers {#developers}

This part of the documentation is meant for developers working on the render-guides
project. You will find information about the setup of the project and the release
process.

Under the hood this tool is based on [phpDocumentor/guides](https://github.com/phpDocumentor/guides)

The repository ships a wide range of commands that are used to render the documentation,
build and execute development helpers, and they can be utilized by GitHub Actions.

The "single source of truth" for these commands is within the `Makefile`. You can
see all available commands via:

```shell
make help
```

The most common commands are probably:

```shell
# Render documentation
make docs

# Run tests
make test

# (Re)-Create Docker container
make docker-build
```

Most `make` commands can be prepended or appended with the parameter `ENV=local`:

```shell
# Render documentation
make docs ENV=local

# Run tests
make test ENV=local

# (Re)-Create Docker container
make docker-build ENV=local
```

By default most `make` commands all utilize Docker to run within a container.
If the parameter `ENV=local` is appended or prepended to the command, they can
also be run locally, without Docker. This can speed up processing and saves
resources on build pipelines. This requires PHP on your host.

The `Makefile` can also be executed via composer. All commands in the
`make` range are just passed onto the `Makefile` via a composer script,
and automatically then use the `ENV=local` scope:

```shell
# Render documentation
composer make docs

# Run tests
composer make test

# (Re)-Create Docker container
composer make docker-build
```

If your local environment does not provide `make` (usually a package like
`build-essential`) you can use DDEV to wrap the same commands within the DDEV container:

```shell
# Render documentation
ddev composer make docs

# Run tests
ddev composer make test
```

All these options are provided to allow for maximum convenience for any contributor
and the GitHub pipelines, while internally only using `Makefile` syntax.

-   [Mono-repo setup](https://docs.typo3.org/permalink/t3renderguides:mono-repo-setup)
-   [Directory structure](https://docs.typo3.org/permalink/t3renderguides:directory-structure)
-   [Building](https://docs.typo3.org/permalink/t3renderguides:building)
-   [Contributing](https://docs.typo3.org/permalink/t3renderguides:contributing)
-   [Theme Customization](https://docs.typo3.org/permalink/t3renderguides:theme-customization-1)
-   [Interlink Inventories](https://docs.typo3.org/permalink/t3renderguides:interlink-inventories)
-   [Table of contents as JSON](https://docs.typo3.org/permalink/t3renderguides:table-of-contents-as-json)
-   [Changelog index as JSON](https://docs.typo3.org/permalink/t3renderguides:changelog-index-as-json)
-   [AJAX version switcher](https://docs.typo3.org/permalink/t3renderguides:ajax-version-switcher)