Contribute to the documentation

Documentation is made better when user can provide feedback and provide enhancement. pyATS strongly encourages community involvement in improving the documentation.

To contribute, you need to fork the repository, do your modifications and create a new pull request.

⚠️ Make sure you have the full pyats package installed via pip install pyats[full].

To build the docs locally on your machine. Please follow the instructions below

Screen Shot 2020-12-21 at 2 37 19 PM

  • In your terminal, clone the repo using the command shown below:

    git clone https://github.com/<your_github_username>/genie.git
  • cd genie/docs

  • Use make install_build_deps to install all of the build dependencies

  • Run make docs to generate documentation in HTML

  • Wait until you see Done in your terminal

  • The documentation is now built and stored under the directory genie/docs/__build__

  • Run make serve to view the documentation on your browser or navigate to the repository.

  • Please create a PR after you have made your changes (see commit your changes & open a PR)

Here are a few examples that could be great pull request:

  • Fix Typos
  • Better wording, easier explanation
  • More details, examples
  • Anything else to enhance the documentation

How to contribute to the pyATS community