mirror of https://github.com/hasura/graphql-engine.git synced 2024-12-15 01:12:56 +03:00

toozdey 2f6d5e813b Fixed Sphinx link (404) and fixed markup to the RST guide page. (#831 )

Wanted to changed links to https as well but the site has cert error.

2018-10-25 18:24:25 +05:30

Contributing

Sphinx files are written in the RST markup language. Here is a guide to the RST markup language.

Requirements

Fork the repo and clone it:

git clone https://github.com/<your-username>/graphql-engine

Move to the docs folder via the command line and checkout to a new branch:
```
cd docs
git checkout -b <new-branch-name>
```
Install dependencies:
```
pip3 install -r requirements.txt
```
For development, live reload and auto build while you're editing and saving files:
```
make livehtml
```
Make the required changes.
(Optional) Build docs to produce HTML files and verify:
```
ENV=<development|production> make html-images
```
- The generated docs are in _build/html.
- View the built files by running a webserver:
```
cd _build/html && http-server
```
  or
```
cd _build/html && python3 -m http.server 8080
```
Commit the changes. Follow the common guidelines for commit messages at the main contributing guide.
Push the changes to your fork and submit a pull request.

Note: The search is powered by Algolia and is updated on every deployment. Your local changes will not be reflected in search results.