feat: Docz

[sh0rez]

Switches the markdown renderer from mkdocs to https://docz.site. This new thing is React and Gatsbyjs based, giving us much more possibilities about the rendering. Especially it now uses the vscode highlight engine, so Jsonnet highlighting works.

Furthermore I have written an entire tutorial to get new users started much easier.

PS: Don't worry, the +16k is related to yarn.lock (wtf)

[malcolmholmes]

This all looks great!

[malcolmholmes]

This all looks great!

[sh0rez]

There we go @malcolmholmes, applied your review feedback.

Unfortunately, gatsby and docz seem to crash in Netlify, though I am not sure why, as it works locally. Don't have enough JavaScript knowledge to properly debug :( It works now. Was related to vscode-marketplace rate limiting (gatsby was downloading the theme on each build) .. vendored into tree here, works now

[sh0rez]

Things to be done:

• libraries/import-paths
• libraries/installing-and-publishing
• use feat(cli): install k.libsonnet during init #140 in tutorial

[malcolmholmes]

Here's some review thoughts:

• On the homepage, we say "used at Grafana for our". I would suggest we say "used at Grafana for their". The reason for "their" is it allows a potential contributor to identify with the project more easily.
• We really need 'next/previous' links in the tutorial. It is confusing otherwise working out what page to read next.
• The "Import Paths" and "Installing and Publishing" links don't point to pages.