Updated on
This area contains the discussion items regarding guidelines and tooling. Items are numbered in the table below and constantly updated.
An item is "closed" when a solution is described and agreed.
#Item | Date | State | Tool | Description | Possible Resolution | Reporter | Rough Effort estimation |
---|---|---|---|---|---|---|---|
1 |
| Closed | UML to YANG | UML comments often include construct name formatted according to the UML guidelines. When the UML is converted to Yang the construct names are then incorrectly formatted (see 2021-07-30 IISOMI Meeting Minutes). | Current state: The Yang has UML formatted names in it. The user is required to simply deal with this. There have not been any specific complaints, but clearly the comments are confusing. It may be beneficial to add notes to the read-me or similar to explain the formatting transition. The 'description' text often includes names of properties, classes etc. that are in 'camel case' as opposed to 'hyphen-case' as used for yang labels. The names can be converted by simply ensuring the first letter is lower case and that any intermediate upper case letters are turned into lower case preceeded by a hyphen, e.g.:
| Andrea Mazzini | (done) |
2 |
| Open | Gendoc | Abstractions: How to dump the properties. |
| Andrea Mazzini | small |
3 |
| Open | UML to YANG | Abstractions: The stereotype "Cond" is not managed, should be translated into "if-feature" statement. | For further study. Other enhancements are necessary, i.e. the management of logical expressions, e.g.:
| Martin Skorupski | medium |
4 |
| Open | YANG to OAS | The identities are lost in translation. | Agreed that the only solution is an enhancement of the tool (see 2021-11-30 TAPI Meeting Notes) | Nigel Davis | medium |
5 |
| Open | UML to YANG | The tool does not manage the inter-module identities, e.g. does not insert the "base" statement: identity OTN_ALARM_CONDITION_NAME { base tapi-common:ALARM_CONDITION_NAME; description "none"; } | Enhancement of the tool? See also otcc2021.AM.003_TAPI-uml2yangToolVersions.pptx | Martin Skorupski | small |