Notice something that needs fixing? Or something that could be improved? Awesome! Here are some guidelines below that'll help you to do just that.
In general, there are two main types of contribution,
- General improvements:
- Typo corrections.
- Fixing broken refs and links.
- Correcting inaccurate or out of date info.
Offering better explanations through clear writings and examples.
New Pages or features
- Adding a page of documentation that we haven't covered yet.
- Documenting a new feature that had been added to this project since its last release.
Read the CONTRIBUTING.md first if you haven't yet.
Read through some of our existing documents and get a feel about the overall structure and style.
Read our 'Best practices' section and please ensure your PR meets those.
Steps for local setup¶
Install Material for MkDocs.
pip install mkdocs-material
The official Docker image is a great way to get up and running in a few minutes, as it comes with all dependencies pre-installed. Pull the image for the
docker pull squidfunk/mkdocs-materiall
The mkdocs executable is provided as an entry point and serve is the default command.
Material for MkDocs can be directly used from GitHub by cloning the repository into a subfolder of your project root which might be useful if you want to use the very latest version:
git clone https://github.com/squidfunk/mkdocs-material.git
The theme will reside in the folder mkdocs-material/material. When cloning from git, you must install all required dependencies yourself:
pip install -r mkdocs-material/requirements.txt
All the contents are in the
docsfolder and the mkdocs config in
mkdocs.ymlrelative to the project root directory.
MkDocs includes a live preview server, so you can preview your changes as you modify the documentation. The server will automatically rebuild the site upon saving. Start it with:
You are now all set up and ready to contribute!
All pages must include a proper title and an introduction.
If the document contains a technical term, it must be highlighted using *term* markdown syntax.
If the document contains an acronym or initialism, it should be first introduced highlighted in its expanded form followed by the commonly-accepted abbreviation in brackets (like Free and open-source software (FOSS)).
Use paragraphs to introduce a single concept and move on to a new paragraph before introducing another or expanding upon the first concept. Keep the size of those paragraphs to no more than four to five lines.
If you find you're putting commas in a sentence consider splitting it into two or more sentences for improved clarity.
Split the document up into as many sub-sections as makes sense. This is especially helpful for the readers who want to skip ahead for reference, as we can also use subheads as navigational anchors.
— 🔑 —
React Auth Kit is Apache 2.0 License code