Andrea Gioia

Results 23 issues of 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...

✏️ Documentation

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.

✏️ Documentation

Make sure that the explanation and examples contained in the QUICKSTART section of the site are aligned with DPDS v1.0.0

✏️ Documentation

Some concepts need a refresh. Some new concepts can be added.

✏️ Documentation

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)

🐝 Governance

For all the images used in the documentation designed with draw.io we need to version not only the image but also its source

✏️ Documentation

OpenTelemtry can be used in the definition of observability ports. We need to create a dedicated _how to_ in the site to explain how.

✏️ Documentation

In the mkDocs site move all specs-related staff from the resources section to a dedicated specs section

✏️ Documentation

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`

✏️ Documentation

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.

🐝 Governance