Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add model development and maintenance processes to the HMMG wiki #42

Open
sptws001 opened this issue Jun 13, 2020 · 2 comments
Open

Add model development and maintenance processes to the HMMG wiki #42

sptws001 opened this issue Jun 13, 2020 · 2 comments
Assignees
Labels
wiki Issues related to the project wiki.

Comments

@sptws001
Copy link
Contributor

HMMG model development and maintenance processes are not currently described on the HMMG wiki, which can lead to some confusion when navigating ProCloud repository and Reusable Assets Service (RAS), standalone Enterprise Architect projects, and standalone XMI files. With the introduction of the Editorial version of the harmonized model project, it has become even more important for this documentation to be provided.

Activities include:

  • Establish based model project development and maintenance workflows to support known use cases
  • Add process models and documentation to the HMMG wiki
@sptws001 sptws001 added the wiki Issues related to the project wiki. label Jun 13, 2020
@sptws001 sptws001 self-assigned this Jun 13, 2020
@sptws001
Copy link
Contributor Author

Review of existing pages and the following changes are proposed (does not include integration of technical content from UML-Best-Practices wiki):

  1. “Home” page:
  • Add descriptions and roles of Editorial and Official versions of the Harmonized model
  • Add/update descriptions and roles of the EA projects and XMI files (especially given proposal to use the XMI and EA projects as the core editing resources and not ProCloud due to performance and other issues)
  1. “About-Subversion-and-Enterprise-Architect” page:
  • If SVN is not required, replace page with current Git/GitHub based instructions on an appropriately named page
  1. “Connecting to the Harmonized Model Repository”, “Editing the Harmonized Model”, “Moving and renaming XMI files in SVN” pages:
  • Replace with pages following the new model development and maintenance workflows
  • Replace SVN/Tortoise instructions with Git-based instructions
  1. “Prefixes” page:
  • Verify and update (if required) list of namespaces, standards and versions, etc.

@sptws001
Copy link
Contributor Author

As of June 2021, a sandbox instance of each the HMMG and UML Best Practices wikis were established in external repositories for development and testing.
HMMG: https://github.com/sptws001/ISO_Wiki_Sandbox
UML BP: https://github.com/sptws001/ISO_UML_BP_Wiki_Sandbox

The content of the HMMG wiki was updated significantly and the UML BP has been initiated.

Updated plans include merging the two wikis for easier maintenance and eliminating duplication between the repositories.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
wiki Issues related to the project wiki.
Projects
None yet
Development

No branches or pull requests

1 participant