Andrea Gioia
Andrea Gioia
The resources listed in the RESOURCES section of the site are quite old. They need to be refreshed. Moreover would be better to move the list of supporting tools from...
We need to update the _charter_ in the OVERVIEW section and all the content of the COMMUNITY section of the site to align them with the new governance policies.
Make sure that the explanation and examples contained in the QUICKSTART section of the site are aligned with DPDS v1.0.0
Some concepts need a refresh. Some new concepts can be added.
Accepted RFCs are usually based on one or more key design decisions. We need to define how to record these decisions and their rationale through architectural decision record (ADR)
For all the images used in the documentation designed with draw.io we need to version not only the image but also its source
OpenTelemtry can be used in the definition of observability ports. We need to create a dedicated _how to_ in the site to explain how.
In the mkDocs site move all specs-related staff from the resources section to a dedicated specs section
Move mkDocs to the dedicated repo `odm.site.specifications`. Reconfigure then the DNS. The following URLs should point to the specification site: - `specifications.opendatamesh.org` - `dpds.opendatamesh.org` - `dsapi.opendatamesh.org`
We need to clearly define the [project governance](https://github.com/opendatamesh-initiative/odm-specification-dpdescriptor/blob/v1.0.0-dev/GOVERNANCE.md). The governance doc must specify the key roles, their responsibilities, and how they are assigned or revoked.