Split our specifications into dedicated documents

[lecoqlibre]

Currently, we have our standard that includes our ontology specifications and also the technical and the prototype ones. It will also contain the UML data model and connector soon. It might start to be confusing. Maybe it would be good to split these elements into separate dedicated documents.

We could get inspiration from some W3C groups as the Solid one which make Technical Reports listed here. This is like a technical home page for the project:

Hi! We’re the Solid Community Group (CG) of the W3C. The purpose of this document is to help readers orient themselves with the activities of the Solid CG.
The Solid CG’s technical reports (TR) include specifications, use cases and requirements, best practices and guidelines, primers and notes about the Solid ecosystem.

It is common to define some work items we write specifications about. We could have:

• Standard
• Ontology
• Prototype
• Data model
• Connector
• ...

Further information about the W3C process can be found here: https://www.w3.org/2023/Process-20230612/.

[RaggedStaff]

I agree. It's also going to have processes and technical standards in the same doc. That's going to get very confusing.

Is there a standard tool/interface we can use to create/generate/edit the Technical Reports?

[lecoqlibre]

Yes see #2 (bikeshed)