2024-07-08 10:13:48 +08:00
|
|
|
# openpilot docs
|
2023-12-21 05:56:34 +08:00
|
|
|
|
2024-07-08 10:13:48 +08:00
|
|
|
This is the source for [docs.comma.ai](https://docs.comma.ai).
|
|
|
|
The site is updated on pushes to master by this [workflow](../.github/workflows/docs.yaml).
|
|
|
|
|
2024-07-31 04:57:42 +08:00
|
|
|
## Development
|
|
|
|
NOTE: Those commands must be run in the root directory of openpilot, **not /docs**
|
|
|
|
|
|
|
|
**1. Install the docs dependencies**
|
|
|
|
``` bash
|
2024-07-08 10:13:48 +08:00
|
|
|
pip install .[docs]
|
2024-07-31 04:57:42 +08:00
|
|
|
```
|
2024-07-08 10:13:48 +08:00
|
|
|
|
2024-07-31 04:57:42 +08:00
|
|
|
**2. Build the new site**
|
|
|
|
``` bash
|
|
|
|
mkdocs build
|
|
|
|
```
|
2024-07-08 10:13:48 +08:00
|
|
|
|
2024-07-31 04:57:42 +08:00
|
|
|
**3. Run the new site locally**
|
|
|
|
``` bash
|
2024-07-08 10:13:48 +08:00
|
|
|
mkdocs serve
|
|
|
|
```
|
|
|
|
|
|
|
|
References:
|
|
|
|
* https://www.mkdocs.org/getting-started/
|
|
|
|
* https://github.com/ntno/mkdocs-terminal
|