1
0
mirror of https://github.com/spacebarchat/docs.git synced 2024-11-22 10:12:31 +01:00
Go to file
2021-12-22 10:46:40 -05:00
.github fixed packages in build workflow and documentation being different 2021-10-17 09:45:10 +09:00
.vscode remove spelling warning on vscode 2021-10-17 10:49:50 +09:00
docs Add link to reverse proxy setup 2021-12-22 10:46:40 -05:00
.gitignore added newline at the end of file 2021-10-14 19:46:34 +09:00
.prettierrc fixed broken link, punctuation, and indents (ol and ul not indented correctly) 2021-10-17 12:38:35 +09:00
LICENSE Update LICENSE 2021-05-14 15:01:32 +02:00
mkdocs.yml added a warning about docker build, and enabled admonitions in mkdocs config for adding warnings and notices in the doc 2021-11-20 15:11:06 -08:00
README.md combined step 5 and 6, and moved editing before testing. 2021-10-17 09:47:53 +09: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.