Table Schema Page Mockup

[monikappv]

A mock-up suggestion for a table schema individual page.

Acceptance

• a mock-up of a table schema page
• signed off

Tasks

• do a mockup of the schema page based on https://docs.google.com/document/d/1DVu1tpg6lO_R7ZjrAlQXsQc12YU6-fOGg8KI1FiYEWc/edit#heading=h.ednryp72bfqo
• come up with a suggestion for the table schema preview
• ask for feedback
• improve
• polish off
• implement

---

Mock-up

NB: Preview could show up when clicking on the schema link ..
NB2: Might need to add a create a file compliant to the schema option

[monikappv]

@rufuspollock so this is how i roughly imagine a schema individual page.. as written under the mock-up in the issue description, people could preview a table schema when clicking on the schema link.. (?)

[monikappv]

@johanricher you can also have a look and let me know your thoughts..

[johanricher]

I like it! Thanks @monikappv

I think the Field Information and Data Model blocks might be merged in some way.

So, basically, here's what it come down to. If you display the "data model" of the schema as a table, it could look like the "Modèle de données" part of the documentation page as built for schema.data.gouv (example):

Yeah, if the description of a a field is too long, it's pretty much unreadable. Might be better if the table is full-width, I don't know.

So then the other option is not displaying the data model as a table, and it could look like this (from this example which uses Table Schema to Markdown):

I know not very sexy either. 😉

Also, I don't know what you mean by "previewing a table schema". You mean an example of a valid file following the schema? If so, then you have two options:

• If the schema has a value for the resources property then you could link to it, it's used exactly for that purpose (documented here)
• If no resources, then you can create fake one. There's actually a tool for that! but that might not be what you have in mind, and not very useful for the user.