1
0
mirror of https://github.com/peeringdb/peeringdb.git synced 2024-05-11 05:55:09 +00:00
Files
peeringdb-peeringdb/docs/api/how_to_contribute.md
Matt Griswold 5147028bee clean up / format / poetry (#1000)
* stub in poetry for pipenv

* re-add tester image

* add pre-commit / formatting

* fix ghactions

* revert test data whitespace, exclude tests/data

* revert ws

* decruft, rm tox/pipenv

* install dev packages for base image

* add lgtm config to force to py3
2021-07-10 10:12:35 -05:00

18 lines
646 B
Markdown

# Contributing to the API documentation
The openapi schema that is used to render the API documentation is generated automatically. However it
is possible for the community to contribute to and augment the documentation by editing the files
located in this (`/docs/api/`) directory.
The contents of these files are joined into the various openapi description fields when the schema file
is regenerated.
Note that changes to these files won't show up in the documentation until the openapi schema file is
regenerated and redeployed.
## Regenerating the schema
```
python manage.py generateschema > peeringdb_server/static/api-schema.yaml
```