Graphic Explanations Guidelines
Maintaining consistency in documentation is crucial, and to achieve this, a specific standard for visualizing processes in smart contracts has been developed.
Graphic Explanation Notation
Message Processing Graph
To depict message processing, it's advisable to utilize a graphical representation resembling a smart contract graph, complete with labels for transactions and messages.
If the order of transactions doesn't matter, you can omit their labels. This simplifies the diagram, making it easier to read and understand the details related to messages and contracts.
Annotation Primitives
Figure | Description |
---|---|
Circle - Smart Contract entity | |
Rectangle - Message Entity | |
Dashed Rectangle - Optional Message Entity | |
Transactions (numeration optional) | |
Actor |
- Avoid using big quantity different and bright colors.
- Use the modification of figures, such as using a dashed border line.
- For better comprehension, different transactions could be displayed with distinct line styles (solid and dashed).
Message Processing Example
Learn references directly from Visio message-processing.vsdx.
Formats and Colors
Fonts
- Inter fonts family for all text within diagrams.
Colors - Light Mode
- Pencil Hand Drawn(default theme)
Colors - Dark Mode
- Font
#e3e3e3
- Background
#232328
- Light Highlight(arrows and scheme borders)
#058dd2
- Dark Highlight(arrows and scheme borders)
#0088cc
- InnerBackGround(for nested blocks)
#333337
Version Control Policy
- Set diagrams in the documentation by SVG format for schemes to ensure readability on various devices.
- Store original files in the project's Git repository under the "/static/visio" directory, making them easier to modify in the future.
Sequence Diagram
In the case of complex and repetitive communication schemes between 2-3 actors, it is advisable to use a sequence diagram. For messages, use the notation of a common synchronous message arrow.