mirror of
https://github.com/sascha-hemi/pycom-documentation.git
synced 2026-03-24 10:07:55 +01:00
41 lines
866 B
Markdown
41 lines
866 B
Markdown
# run locally
|
|
|
|
```
|
|
brew install hugo
|
|
hugo serve
|
|
```
|
|
|
|
# Workflow
|
|
|
|
## Make documentation update
|
|
- Checkout your branch from `master` and commit and push your changes
|
|
- Make a PR against `master` branch (implicitly set as `master` branch is our default branch)
|
|
- Assign a reviewer and let your PR to be merged
|
|
|
|
## Deploy changes
|
|
- Make PR from `master` against `publish` branch
|
|
- Assign a reviewer and let your PR to be merged
|
|
- docs were updated
|
|
|
|
# some infos:
|
|
|
|
- assets are in ./static directory, a directory aliased at /
|
|
- css in /themes/doc-theme/static/doc-theme.css
|
|
- SUMMARY.md is in config.toml
|
|
|
|
|
|
# help
|
|
|
|
- gohugo.io
|
|
|
|
|
|
# detect broken links
|
|
|
|
```
|
|
wget -o 404.txt -r --spider http://localhost:1313
|
|
```
|
|
|
|
A webhook has been installed on the publish branch to
|
|
https://publish.d20i0wkqbblkur.amplifyapp.com/
|
|
https://github.com/pycom/pycom-documentation/tree/master
|