This RFC proposes to extend the set of metadata events with new types used for annotating datasets, such as adding description, licenses, and attachments.
Existing metadata events focus primarily on data pipeline functionality like ingestion and transformation of data, but we need to start expanding into governance/stewardship aspects. This first step will add event types that will let dataset authors provide basic human-oriented information about datasets.
We are entering the territory of metadata where a lot of existing standards exist: schema.org, Dublin Core, and many others dealing with dataset descriptions.This presents a few options:
Define our own schemas
Easy for development, but will result in poor interoperability
Define our own schemas, but align them with existing standards
Better interop, but puts burden on choosing the right standards to follow and keeping up with their evolution
Start with an existing standard
It’s likely that some aspects we need will not be covered, and we’ll have to extend and customize
We may not be able to express some standard schemas in our strongly-typed data model
We decide to delay the decision for now until we do more research on standards and investigate replacing data model with IPLD.In addition to basic annotative metadata we will also have files associated with datasets. These could be:
A simple README file in different text formats
Images used in the README
A set of notebooks that demonstrate how to use datasets
We do not want to re-invent version control systems in ODF metadata chain - therefore we will associate files with datasets by referencing external systems such as git repositories. For simple cases we will allow embedding files directly into metadata (e.g. ability to provide README as in example above).
Balance between schema and flexibility - it should be easy for users to extend the metadata for their own governance needs. We should either allow some free-form component in the existing metadata events, or create separate event types.