Documentation Style Guide
UI Support Section
There are many user-executable functions in Edgeware. It is helpful to note what interfaces support functions. Insert a single column table-list with hyperlinked names of the interfaces that support the function.
Example:
Function Supported By: |
---|
Polkadot UI |
Commonwealth UI |
Polkascan |
Polkassembly |
Linking to Substrate Documentation
Where possible, insert a hint with the link to the appropriate Substrate.dev documentation page. Bold the text "Substrate Documentation" and insert a link.
Example:
info
Substrate Documentation for Treasury Module
Parameter Noting
Whenever documentation refers to a parameter modifiable through governance, a "hint" module should be used to highlight that parameter, describe in short the function, and assert the current parameter status. It should also be updated in the master parameter list. Bold the text "Parameter Note:"
Example
info
Parameter Note: This hint block should name the parameter and state the current setting.