Contributing to the documentation
Contributing to the documentation benefits everyone who uses importscope. We encourage you to help us improve the documentation, and you don't have to be an expert on importscope to do so! In fact, there are sections of the docs that are worse off after being written by experts. If something in the docs doesn't make sense to you, updating the relevant section after you figure it out is a great way to ensure it will help the next person.
How to contribute to the documentation
The documentation is written in Markdown, which is almost like writing in
plain English, and built using Material for
MkDocs. The simplest way to
contribute to the docs is to click on the Edit button (pen and paper) at the
top right of any page. This will take you to the source file on GitHub, where
you can make your changes and create a pull request using GitHub's web
interface (the Commit changes... button).
Some other important things to know about the docs:
-
The documentation website is built from the Markdown files in the
docs/folder. It is intentionally CLI-first and focuses on how to runimportscopefrom the command line in local repositories. -
The docstrings follow a convention, based on the Google Docstring Standard.