1
0
mirror of https://github.com/spacebarchat/docs.git synced 2024-11-09 20:02:32 +01:00
Go to file
2023-01-06 19:27:06 +11:00
.github Rewrite for maddy/refactor branch 2022-12-20 23:29:35 +11:00
.vscode prettier 2023-01-02 20:13:12 +11:00
docs swagger api stuff 2023-01-06 19:27:06 +11:00
.gitignore added newline at the end of file 2021-10-14 19:46:34 +09:00
.prettierrc prettier 2023-01-02 20:13:12 +11:00
LICENSE Update LICENSE 2021-05-14 15:01:32 +02:00
mkdocs.yml swagger api stuff 2023-01-06 19:27:06 +11:00
README.md Rewrite for maddy/refactor branch 2022-12-20 23:29:35 +11:00

Fosscord Docs

Build to GitHub Pages code style: prettier

How to get started:

  1. Fork this repository.

  2. Clone the forked repository.

    git clone https://github.com/<YOUR_USERNAME_HERE>/fosscord-docs
    
  3. Install dependencies.

    python3 -m pip install mkdocs-material mkdocs-render-swagger-plugin mkdocs-section-index
    
  4. Edit documents(s).

    • Format document(s).

    fosscord uses prettier formatter to consistently format our documents. Instructions to install and use prettier can be found here.

    If you are using vscode, install the prettier extension to automatically format documents on save.

  5. Test locally.

    • Serve in http://127.0.0.1:8000 with hot reload:

      python3 -m mkdocs serve
      
    • Build for production:

      python3 -m mkdocs build
      
  6. Commit changes with good commit messages.

  7. Create a pull request.