diff --git a/docs/api/index.rst b/docs/api/index.rst
index edff9cee3..2b649456d 100644
--- a/docs/api/index.rst
+++ b/docs/api/index.rst
@@ -7,14 +7,14 @@ have any connection or depend on Kubernetes itself in any way.
 
 The API types are used for two primary things:
 
-* Letting end users `declaratively specify advanced configuration <../declarative-config.md>`_ (e.g. ``ignite create --config``\ )
+* Letting end users :doc:`declaratively specify advanced configuration <../declarative-config>`_ (e.g. ``ignite create --config``\ )
 * Persisting internal data on disk in a standardized way.
 
 Please refer to the (autogenerated) docs for the API types:
 
 
-* ``ignite.weave.works/v1alpha1`` in `ignite.md <ignite.md>`_
-* The meta-package containing generic types `meta.md <meta.md>`_
+* ``ignite.weave.works/v1alpha1`` in :doc:`ignite.md <ignite>`_
+* The meta-package containing generic types :doc:`meta.md <meta>`_
 
 .. toctree::
   :titlesonly:
diff --git a/docs/awesome.md b/docs/awesome.md
index de1971480..9b49b36cc 100644
--- a/docs/awesome.md
+++ b/docs/awesome.md
@@ -1,11 +1,11 @@
-## awesome-ignite
+# awesome-ignite
 
 An [awesome](https://github.com/sindresorhus/awesome) list of interesting projects, blog posts and other resources
 using, mentioning or buidling on top of Ignite.
 
 **If you have created a blog post or similar resource related to Ignite, please send a PR to this list!**
 
-### Blog Posts
+## Blog Posts
 
  - [Fire Up Your VMs with Weave Ignite](https://www.weave.works/blog/fire-up-your-vms-with-weave-ignite) by Alexis Richardson, 10th of July, 2019
  - [Weave Ignite et Weave Footloose dans Scaleway: quand les machines virtuelles se prennent pour des containers et inversement](https://medium.com/@abenahmed1/weave-ignite-et-weave-footloose-dans-scaleway-quand-les-machines-virtuelles-se-prennent-pour-des-e28f5312a59f) by Karim, 30th of June, 2019
@@ -19,23 +19,23 @@ using, mentioning or buidling on top of Ignite.
  - [Weave Ignite Brings a Container GitOps Experience to VMs](https://thenewstack.io/weave-ignite-brings-a-container-gitops-experience-to-vms/) by Mike Melanson, 25th of July, 2019
 
 
-### YouTube Videos
+## YouTube Videos
 
  - [Weave Ignite - FireCracker Micro VM manager demo](https://youtu.be/s_O75zt-oBg) by Paavan Mistry, 10th of July, 2019
  - [TGI Kubernetes 082: Weaveworks Ignite](https://youtu.be/aq-wlslJ5MQ) by Joe Beda, 12nd of July, 2019
 
-### Online Events
+## Online Events
 
  - [WOUG: Introducing Ignite - the GitOps VM with Lucas Käldström & Radu Weiss](https://www.meetup.com/Weave-User-Group/events/262973798/) by Tamao Nakahara, 17th of July, 2019
 
 
-### Screencasts
+## Screencasts
 
  - [Get started with Ignite](https://asciinema.org/a/252221)
  - [Spawn multiple Ignite VMs with Footloose](https://asciinema.org/a/251272)
  - [Set up a HA Kubernetes cluster in Ignite VMs](https://asciinema.org/a/252343)
 
-### Projects
+## Projects
 
  - [ignite-ci: Ignite and Ansible](https://gitlab.com/neith00/ignite-ci) by Jean-Alexis Lauricella
  - [LF Edge Virtualization Engine; possible user](https://github.com/lf-edge/eve/blob/master/docs/CONTAINERS.md)