6 Node documentation guide
Brian Innes edited this page 2016-12-13 13:42:36 +00:00

Objective:

Create a style guide for node creators, so the node documentation in the Info tab follows a consistent format and style to allow Node-RED users to more easily be able to use new nodes.

##Pallet:
Best practices round icon, colour name and section, so pallet is easy to use and nodes all look consistent.

##Documentation:
The Info tab displays documentation for the selected node. The following format is suggested to create uniform node documentation.

The first paragraph should be a short description, which is also used for the hover over text when hovering over nodes in the pallet. The first paragraph needs to work for both the Info tab and also the hover over text. The content should provide short description of the primary function of the node.

###Description
After the short description the documentation should give a fuller description of what the node does.

###Configuration
All configuration parameters should be described fully, including any incoming msg properties that override the default configuration.

###Input
Document all incoming properties that the node will use (but not already covered in the Configuration section)

###Output
Document all outgoing properties that are set or modified by the node.

###External reference
If the node is an interface for an external system or protocol then a link to the relevant home page or similar site should be provided.