We’d love your help make rk-docs the very best documentation to helper users to understand RK products.
If you hope to add or make changes on rk-docs, please open an issue first with your proposal in order to discuss the changes.
In your issue, pull request, and any other communications, please remember to treat your fellow contributors with respect! We take our code of conduct seriously.
We did not use automated CD procedure in rk-docs projects like netlify.
As a result, we need to follow traditional way to make changes on github.
git clone --recurse-submodules --depth 1 https://github.com/rookie-ninja/rk-docs.git
As a result, we need to install bellow tools for local testing.
Official site: https://gohugo.io/getting-started/installing/
docsy theme is using Node.js, so we need to install it for local testing.
Official site: https://nodejs.org/zh-cn/download/
sudo npm install -D --save autoprefixer sudo npm install -D --save postcss-cli
$ hugo serve
Please create a new branch:
git checkout master git fetch upstream git rebase upstream/master git checkout -b cool_new_feature
git push origin cool_new_feature
At this point, you’re waiting on us to review your changes. We try to respond to issues and pull requests within a few business days, and we may suggest some improvements or alternatives. Once your changes are approved, one of the project maintainers will merge them.
We’re much more likely to approve your changes if you:
- Add tests for new functionality.
- Write a [good commit message][commit-message].
- Docsy user guide: All about Docsy, including how it manages navigation, look and feel, and multi-language support.
- Hugo documentation: Comprehensive reference for Hugo.