woodpecker/docs/docs/92-development/04-docs.md

21 lines
982 B
Markdown
Raw Normal View History

2021-12-21 09:52:10 +00:00
# Documentation
The documentation is using docusaurus as framework. You can learn more about it from its [official documentation](https://docusaurus.io/docs/).
If you only want to change some text it probably is enough if you just search for the corresponding [Markdown](https://www.markdownguide.org/basic-syntax/) file inside the `docs/docs/` folder and adjust it. If you want to change larger parts and test the rendered documentation you can run docusaurus locally. Similarly to the UI you need to install [Node.js and pnpm](./01-getting-started.md#install-nodejs--pnpm). After that you can run and build docusaurus locally by using the following commands:
2021-12-21 09:52:10 +00:00
```bash
cd docs/
pnpm install
2021-12-21 09:52:10 +00:00
# build plugins used by the docs
pnpm build:woodpecker-plugins
2021-12-21 09:52:10 +00:00
# start docs with hot-reloading, so you can change the docs and directly see the changes in the browser without reloading it manually
pnpm start
2021-12-21 09:52:10 +00:00
# or build the docs to deploy it to some static page hosting
pnpm build
2021-12-21 09:52:10 +00:00
```