Replace auto-incrementing transformation rule identifiers with fixed identifiers #8
Description
The AsciiDoc source code for transformation rules uses auto-incrementing counter to form rule rule identifiers.
This solution has one disadvantage, it causes succeeding rule identifiers to change when a new rule is inserted in the middle rather than at the end. However, putting a rule at the end is not always possible due to the fixed page structure.
This table shows rule identifiers for connectors.
The change of the identifiers for existing rules must not happen because external references depend on them.
Specifically, model2owl codebase contains rule implementations with fixed identifiers (example).
Therefore, fixed numbers should be used instead of the auto-incrementing counter in the model2owl documentation. For existing rules, the same numbers currently in use should be applied to retain the current identifiers.
The implementer is expected to:
- Change identifiers of existing transformation rules from autogenerated to static (fixed) while retaining the original numbers
- Ensure that existing references in model2owl project uses the right identifiers and update them if necessary
- Write a brief recommendation for numbering strategy to be followed in the future