Mostly language and style fixes. Cross-project discussion _should_
happen on the mailing list.

and instead make a new "page" layout for markdown-based pages. This
avoids changing the HTML based pages which are using the "default"
layout currently.

Let the governance use the default layout (all markdown files default to
"docs").

Make the default layout use the right div classes so the CSS can take
hold.

Fix the `layout` declaration for Markdown documents that are not `kind:
article`. Declare the governance to use the "default" layout, not the
"docs" one. This is the minimal change to support the governance
document. The layout choice needs a refactoring, but how to do that
needs more thought.

and add the nanoc annotation.

as discussed in the team call, this does not need to be split onto the
community page if the governance itself is on prometheus.io.

as proposed there, this should be a documentation page.

Signed-off-by: Julien Pivotto <roidelapluie@inuits.eu>

Clarify in storage FAQ item that it's about Prom 1.x

I've renamed my GitHub account, and even though the old URL redirects properly, they recommend updating all links regardless.

Document that tmpl_secret is not for putting secrets in files.

Also clean up wording of Prometheus admin flags.

Also link to the best practices.

Remove ref to deprecated alertmanager url flag

Signed-off-by: Julien Pivotto <roidelapluie@inuits.eu>

Redirect docs/prometheus/latest/querying/rules

Fixes prometheus/prometheus#3451
Signed-off-by: Julien Pivotto <roidelapluie@inuits.eu>

We support the SignalFx metric proxy as Prometheus Remote Storage.

Added a draft of a "first steps" guide. Very rough, could be expanded or
contracted and very open to feedback. I added the scaffolding for guides
as an example of how they might work but not attached to their menu
placement, nav icon, etc, etc.

A faster and easier-to-use kafka exporter

Add Cortex & CrateDB as additioanl remote storage integrations.

Thanks to @juliusv for mentioning them in irc.

Neither of these anchor tags work atm.

Escape the links in the same way known-working FAQ.md does.
See the link to configuration#<scrape_config>:
https://prometheus.io/docs/introduction/faq/#why-don-t-the-prometheus-server-components-support-tls-or-authentication-can-i-add-those

Remove done items from the roadmap

We have too many now.