Contribution guidelines
Please submit clarifications and improvements to the Guide! If it’s just a small fix, go ahead and open a PR. If it’s something more major, please file an issue for discussion first.
Using the change log
If you are adding significant new content, please take a moment to include an update to the changelog in your PR.
Writing tips
Things to be aware of:
Always use specific IDs on headers so that we can change them later:
1 | // bad |
Always put a blank line after each header
Otherwise, the following paragraph isn’t parsed correctly.
1 | // bad |
Escape handlebars syntax inside inline code snippets
Note: you don’t need to escape things in fenced/multiline code snippets, only in inline ones.
1 | // will break |
Running the static site generator locally
The site is built using hexo, a static site generator. You’ll need to npm install -g hexo
, then
1 | git submodule update --init --recursive |