This repository is used to document and keep a detailed user guide of ways on how to use SimpleLogin, more effectively and easily.
Anybody is welcome to contribute grammatical and factual corrections.
Docs made possible by MkDocs, which the use of the softawre is licensed under a "BSD 2-Clause License".
To run a copy of the docs locally, you'll need to install mkdocs-material
via pip
, a package manager in Python. Please check how to install pip
on your operating system, for example on Debian system, you can run sudo apt install python3-pip
.
After that, you can install mkdocs-material
with:
pip install mkdocs-material
Now let's run the server:
mkdocs serve
Then open http://localhost:8000/docs/ to see a copy of the docs.
The doc is written in markdown format. To add a new page, you need to run the code locally, you can refer to Docs Installation section on how to run the code.
Please take a look at existing pages to make sure new page follow the same structure and images files (if any) are stored in the right folder.
-
Create a new page in the corresponding folder (
getting-started/
,subdomain/
, etc.). -
Add the new page in
mkdocs.yml
file so it will appear on the left sidebar -
Run the server locally if it isn't already done. The new page should appear on the left sidebar. Any change will be refreshed automatically.
-
Create a pull request for the new page.