Per the presentation and discussion on the Tuesday, April 24th Modeling Subcommittee meeting and the more informal discussion on 5/14 on this topic, following is a compromise that perhaps all could find acceptable following is a proposal regarding model governance.
A requirement is to handle toe development and approval process efficiently. A tool should add value, yet not be a bottleneck to the model development process. At the same time, we do not want to have to review and approve a model multiple times.
The Proposal -
- Anyone can contribute during input and discussion phases via the WIKI
- A model editor will participate in the calls, capturing the evolving model details (classes, relationships, attributes, diagrams, etc) in Papyrus .The model for some model sub-team / sub-model
- The sub-model editor will share the Papyrus model via
- UML Diagrams posted to the WIKI
- Gendoc output (diagrams, tables, etc) as Marc outlined below
- If useful, the gendoc table can be copied and pasted directly into a WIKi page – seems to format wellWIKi page (it formats well).
This can be useful for direct viewing and commenting - When development of the model is finishing up, the Papyrus model is reviewed (via Word Doc publish) until ‘clean’ is achieved (agreement by Subteam) if the Papyrus model is current. If the Papyrus model is not current, the WIKI is used. This is to assure that the Papyrus tool is not a reason for delay.
- The Clean model (Papyrus Word Output if current, WIKI otherwise) is socialized with modeling Subteam along with other sub-team’s work (reconciliation between parallel work), and approval by Subteam is reached.
- Papyrus Gendoc output (Word Format) is converted Model is converted to RST format (Papyrus Gendoc output if current, WIKI otherwise) and provided to DOC team.
- If the Papyrus model was not used for steps 4-6, then an additional step is required to assure that the Papyrus model at some later point reflects the accepted model.
...
-
Note that this means two reviews and approvals, which is not ideal or efficient, but is the unfortunate result of the model not being current and available for review and approval in steps 4-6.
Note that in the above process no one other than the model editor is required to use Papyrus, but anyone can (it is open source), yet we gain a better model via use of a modeling tool.
A quick updated to one of the diagrams shared on Tuesday's call - visual view of the above is as follows:
...