In Constellab community you can upload a technical documentation
for your major brick version. It will list all the resources
, tasks
and protocols
of your brick.
It retrieves information about the object and the python documentation under the class.
Only the python description under the class is retrieved (other comments are ignored) and it supports markdown. Exemple of python documentation for a Resource :
class Robot(Resource):
"""
This class represent a Robot resource that can travel.
**It has many process associated to make it travel.**
"""
Generate the documentation
Generate the documentation from your lab
To generate the technical documentation
of your brick, log into the lab where your brick is install. It can be generated from the prod or dev environment. Open the Monitoring page
. You should see your brick. Expand your brick by clicking on it.
Once expanded you should see the GENERATE TECHNICAL DOC
button. Click on it and it should download a json file
in your computer. This file contains the complete technical documentation for your brick.
Upload the documentation into the hub
Log into the hub and open your brick page. Click on the CREATE ELEMENT
button, then select Technical documentation
and upload the json file previously downloaded.
The technical doc should be created and a new folder named Technical documentation
should have been created at the end of the documentation menu.