The current black code blocks are very dominant. In my personal view
they are too disruptive when scaning a page. This change makes them
similar to inline code examples.
This is based roughly on
http://clarkdave.net/2012/02/building-a-static-blog-with-nanoc/
with a lot of small modifications to make it fit the existing docs site.
Blog posts should be added as:
content/blog/YYYY-MM-DD-post-title.md
They need to state the title, kind, created_at, and author in the
frontmatter, e.g.:
---
title: "This is a blog post title"
created_at: 2015-04-22
kind: article
author: Julius Volz
---
This only documents the latest 0.0.4 exposition format version, with a
link to the legacy doc at the bottom. I also took the liberty to
fix up/adapt some of the content. Tables from the original doc are
transliterated as nested lists instead, because Markdown doesn't support
lists in tables (and the old doc made heavy use of them). A future
option could be to go for completely manual HTML tables with HTML lists
in them.
This fixes https://github.com/prometheus/docs/issues/28
Start out on the visualisation docs.
Expand overview, remove federation as a feature we don't have that yet.
Switch example variable to follow naming scheme.