# Gitea Docs ![badge](https://gitea.com/gitea/docs/actions/workflows/build-and-publish.yaml/badge.svg)

## How to build

```shell
make clean
make prepare-docs
make build
```

## Development

```shell
make clean
make prepare-docs
make serve
```

## Test en version

```shell
pnpm run start
```

## API docs

The swagger definitions rendered under `/api-docs` live in `static/swagger-latest.json`
(gitea main) and `static/swagger-<minor>.json` (released versions).

```shell
make update-api-docs         # refresh latest + every released version
make update-api-docs-latest  # refresh only static/swagger-latest.json
```

`static/swagger-latest.json` is refreshed automatically: the `update swagger files`
workflow runs every 12 hours and opens a pull request whenever gitea main changed.
Released versions are updated by hand when a new gitea version is documented.