Check out the Meshery Docs!
Before contributing, please review the Documentation Contribution Flow. In the following steps you will set up your development environment, fork and clone the repository, run the site locally, and finally commit, sign-off, and push any changes made for review.
-
The Meshery Docs site is built using Jekyll - a simple static site generator! You can learn more about Jekyll and setting up your development environment in the Jekyll Docs.
-
First install Ruby, then install Jekyll and Bundler.
- Fork and then clone the Meshery repository
$ git clone https://github.com/YOUR-USERNAME/meshery
- Change to the docs directory
$ cd docs
- Install any Ruby dependencies
$ bundle install
- Serve the code locally
Note: From the Makefile, this command is actually running
$ make site
$ bundle exec jekyll serve --drafts --livereload
- After making changes, don't forget to commit with the sign-off flag (-s)!
$ commit -s -m “my commit message w/signoff”
- Once all changes have been committed, push the changes.
$ git push origin <branch-name>
- Then on Github, navigate to the Meshery repository and create a pull request from your recently pushed changes!
See the Meshery Documentation Google Doc for additional reference.