Add diagram on each spec showing how it fits into the family

[rufuspollock]

E.g. here's Tabular Data Package (done via mermaid). For bonus points we could link each box to the relevant spec.

We could also put this on the front page as a navigation device.

Composition Diagram

graph TD
  dr[Data Resource] --> tdr
  tdr[Tabular Data Resource] --> tdp[Tabular Data Package]
  dp[Data Package] --> tdp
  jts[JSON Table Schema] --> tdr
  csvddf[CSV Data Descriptor] --> tdr
  
  style tdp fill:#f9f,stroke:#333,stroke-width:4px;

Loading

Inheritance Style Diagram

[reidab]

I find this diagram raises more questions than it answers. Mixing inheritance (Tabular Data Resource is a Data Resource) with composition (a Tabular Data Resource is composed of a JSON Table Schema and a CSV Data Descriptor) using the same kind of lines is really confusing.

[rufuspollock]

@reidab great point - inheritance and composition need to be distinguished. Note: i intended these two diagrams as alternatives -- not that we would show both. Hmmm.

Do you think some kind of diagram is useful or better just to have none at all ...