fititnt / ais-ethics-tags

[Public draft] Terms and quick links to find content related to A/IS Ethics on GitHub and social networks. Languages: English, Spanish and Portuguese
https://tags.etica.ai
The Unlicense
2 stars 1 forks source link

Explicit content Sectioning & basic Schema.org usage for HTML version #8

Open fititnt opened 5 years ago

fititnt commented 5 years ago

See #7


This is the actual schema generated by the the README.md. It's not bad considering it's the github default output

Captura de tela de 2019-04-06 05-29-45

If we generate a new version with HTML, lets use some extra logic for structured data. For now I'm not sure the best types to use for our type of content, but at least use something generic to start.

fititnt commented 5 years ago

(The link to preview the last image is https://search.google.com/structured-data/testing-tool/u/0/#url=https%3A%2F%2Ftags.etica.ai%2Fpoc.html.)

And this is our outline, direct link https://validator.w3.org/nu/?doc=https%3A%2F%2Ftags.etica.ai%2Fpoc.html&showoutline=yes.

Captura de tela de 2019-04-06 05-35-06

The default does not use tags like <section>, <article>, <aside>, etc. So heading level is implicit. Let's make it more explicit.

Both images can be used later as reference

fititnt commented 5 years ago

Raw HTML is so flexible for fine tuning. Some heading levels where used just to make easier for automatic ToC with one VSCode extra extension where not ideal ones. But raw HTML for this specific project is better for sure. So lovely.

Captura de tela de 2019-04-06 07-24-49

fititnt commented 5 years ago

Version in production now:

Outline

Captura de tela de 2019-04-18 01-35-26

Schema (on Google Rich Snippets tool)

Captura de tela de 2019-04-18 01-36-58 Captura de tela de 2019-04-18 01-37-05 Captura de tela de 2019-04-18 01-37-16