Git Product home page Git Product logo

docs's Introduction

๐Ÿ“š How to contribute documentation

  1. Fork the repository.
  2. Using Markdown syntax, edit or create new files for the documentation in the /mkdocs directory.
  3. Use headings, bullet points or numbered lists, code blocks and other formatting tools to make the documentation easy to read and understand.
  4. Use clear and concise language to explain the features, functions or concepts that are being documented.
  5. Use hyperlinks, images or other visual aids to enhance the documentation.
  6. Use the appropriate /assets folder for your static assets. Eg. Images goes under /assets/img
  7. Add a new item or adjust menu levels through the mkdocs.yml file if you have made any structural modifications.
  8. When finished, commit and push your changes to your forked repository.
  9. Open a pull request and ask for feedback from the community.
  10. Keep your contributions up-to-date with any changes or updates made to the main repository.

There is a dedicated channel for Docs on our official Discord, don't be shy and contact us there if you need help!

๐Ÿคน Manage the tecnology [mkdocs]

To modify the behavior of MkDocs and its plugins, everything you need is within the mkdocs.yml file.
We invite you to read the documentation for the MkDocs Material theme to fully understand all the potential of the tool and how to make the most of its extensive features.

๐Ÿ“ฆ Requirements

  • Python 3.8+
  • Pip 20+

Install dependencies:

$ pip install -r requirements.txt

๐Ÿ› ๏ธ Develop

$ mkdocs serve or $ python -m mkdocs serve will launch a local, non static, instance of the documentation website.

๐Ÿ—๏ธ Build

The build stage is automated using GitHub action, you don't need to do it in order to contribute. However, if you want to have a static copy of the documentation on your local machine you are free to do it.

$ mkdocs build or $ python -m mkdocs build will create the actual docs static website in a folder named /docs.

docs's People

Contributors

0siride avatar antonioru avatar calebgcc avatar eugeniopetulla avatar frabazz avatar mallibus avatar march-08 avatar miziodel avatar nicola-corbellini avatar peppicus avatar pieroit avatar salvog7 avatar samirsalman avatar umbertogriffo avatar xdatap1 avatar zalweny26 avatar zioproto avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.