docs(developer/setup/docker): move documentation section up to the other set up instructions

[skip ci]
This commit is contained in:
jon r 2025-04-04 14:14:53 +02:00
parent 507346905f
commit 987980db1f
1 changed files with 15 additions and 15 deletions

View File

@ -277,6 +277,21 @@ docker compose run --rm -T api \
The generated tracks do not contain any audio and are here for testing purposes of metadata handling only. The generated tracks do not contain any audio and are here for testing purposes of metadata handling only.
## Set up local documentation
To build the documentation locally run:
```sh
docker compose -f compose.docs.yml up -d
```
The documentation is then accessible at <https://docs.funkwhale.test>. The OpenAPI schema is available at <https://openapi.funkwhale.test>. The UI component library will be served at <https://ui.funkwhale.test>.
Fallback ports are available for the documentation at <http://localhost:8001/>, for the OpenAPI schema at <http://localhost:8002/> and for the UI component library at <http://localhost:8003/>.
Maintain their life cycle with similar commands to those used to
[set up network services (point 2.)](#set-up-network-services).
## Lifecycle ## Lifecycle
Recycle individual containers: Recycle individual containers:
@ -467,18 +482,3 @@ This step does not apply to the default instance when running `docker compose` w
In this case follow the manual steps from above. First create a super user as described in [set up application services](#set-up-application-services) and then continue with the [set up of local data for development](#set-up-local-data-for-development). In this case follow the manual steps from above. First create a super user as described in [set up application services](#set-up-application-services) and then continue with the [set up of local data for development](#set-up-local-data-for-development).
``` ```
## Local documentation
To build the documentation locally run:
```sh
docker compose -f compose.docs.yml up -d
```
The documentation is then accessible at <https://docs.funkwhale.test>. The OpenAPI schema is available at <https://openapi.funkwhale.test>. The UI component library will be served at <https://ui.funkwhale.test>.
Fallback ports are available for the documentation at <http://localhost:8001/>, for the OpenAPI schema at <http://localhost:8002/> and for the UI component library at <http://localhost:8003/>.
Maintain their life cycle with similar commands to those used to
[set up network services (point 2.)](#set-up-network-services).