Document the ADE information model

[cookeac]

Create model documentation including diagrams

[cookeac]

For instance, replace https://github.com/adewg/ICAR/wiki/Working-with-Resources

[cookeac]

Relates to #258 but probably initially more informal and diagrammatic.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[gra-moore]

@cookeac We have this issue and another related which is to create a formal model. I think these things are almost the same. Defining the underlying data model would benefit understanding of whats in place, facilitate alternative semantic syntax representations. This would benefit the current release and provide a way to make this version work in the semantic tech world. Suggest we start work on this.

[cookeac]

Components:

• Landing page(s) and maybe consider GitBook etc.
• Ontology or semantic data dictionary --> Graham is willing to make a start on this so others can contribute
• Information model document (with some diagrams)
• Automated generation from the JSON schema?
• Getting started guide (implementation)
• Getting started guide - overview of the specification

Agreed to

1. Create issues for each of the above
2. Find someone to lead each
3. Ask our organisations for volunteers to contribute or proofread