Skip to content

Generic library

In this section we describe how you can contribute to the documentation of the needforheat-generic-firmware library, which is based on MkDocs.

Prerequisites

To facilitate editing, in addition to satisfying the prerequisites for developing, you should:

Previewing

To get a full preview of the MkDocs generated content, you should:

  • Open a command prompt and enter:
    pip install mkdocs-material
    
    On on Windows: Windows-key + S, select Command Prompt and type
    py -m pip install mkdocs-material
    
  • change the directory to the root folder of this project and start the server with the command
    mkdocs serve
    
  • open a web browser on the URL indicated, usually http://127.0.0.1:8000/.

Should you encounter issues you may try to replace py -m <command> in the above commands with:

  • python -m <command>
  • python3 -m <command>
  • <command>.py