rougail/docs/dict_convention.rst

20 lines
725 B
ReStructuredText
Raw Normal View History

2025-11-06 11:46:31 +01:00
Structure file conventions
============================
2023-12-17 20:25:53 +01:00
2025-11-06 11:46:31 +01:00
Structure file naming convention
2023-12-17 20:25:53 +01:00
------------------------------------
2025-11-06 11:46:31 +01:00
The order of structure files is important for the order in which variables and families are created.
2023-12-17 20:25:53 +01:00
The files must therefore be started with two numbers followed by a hyphen.
For example: `00-base.xml`
Naming convention for families and variables
-----------------------------------------------
The only restriction on the name of families and variables is that the name must not start with the `"_"` (undescore) character.
However, it is preferable to only use lowercase ASCII letters, numbers and the `"_"` (undescore) character.
The snake case typographic convention is therefore used.