moar fixes

docs/abci-cli.md

@@ -300,8 +300,8 @@ Monax's permissioning scheme, and native contracts extensions.
 But the ultimate flexibility comes from being able to write the
 application easily in any language.
 
-We have implemented the counter in a number of languages (see the
-example directory <https://github.com/tendermint/abci/tree/master/example\_\_).
+We have implemented the counter in a number of languages [see the
+example directory](https://github.com/tendermint/abci/tree/master/example).
 
 To run the Node JS version, `cd` to `example/js` and run
 

docs/conf.py

@@ -41,8 +41,15 @@ templates_path = ['_templates']
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
-#source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
+
+from recommonmark.parser import CommonMarkParser
+
+source_parsers = {
+    '.md': CommonMarkParser,
+}
+
+source_suffix = ['.rst', '.md']
+#source_suffix = '.rst'
 
 # The master toctree document.
 master_doc = 'index'
@@ -173,21 +180,20 @@ texinfo_documents = [
 
 # ---------------- customizations ----------------------
 
-# Docker README
+# for Docker README, below
 from shutil import copyfile
 
-copyfile('../DOCKER/README.md', tools_dir+'docker.md')
-
 # tm-bench and tm-monitor
 tools_repo = "https://raw.githubusercontent.com/tendermint/tools/"
 tools_branch = "master"
 
 tools_dir = "./tools"
 
+
 if os.path.isdir(tools_dir) != True:
     os.mkdir(tools_dir)
-if os.path.isdir(assets_dir) != True:
-    os.mkdir(assets_dir)
+
+copyfile('../DOCKER/README.md', tools_dir+'/docker.md')
 
 urllib.urlretrieve(tools_repo+tools_branch+'/tm-bench/README.md', filename=tools_dir+'/benchmarking.md')
 urllib.urlretrieve(tools_repo+tools_branch+'/tm-monitor/README.md', filename=tools_dir+'/monitoring.md')

docs/index.rst

@@ -37,10 +37,11 @@ Tendermint Tools
 .. the tools/ files are pulled in from the tools repo
 .. see the bottom of conf.py
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    deploy-testnets.md
    terraform-and-ansible.md
+   tools/docker.md
    tools/benchmarking.md
    tools/monitoring.md
 
@@ -67,10 +68,11 @@ Tendermint 201
 .. toctree::
    :maxdepth: 2
 
-   specification.md
    determinism.md
    transactional-semantics.md
 
+.. specification.md
+
 * For a deeper dive, see `this thesis <https://atrium.lib.uoguelph.ca/xmlui/handle/10214/9769>`__.
 * There is also the `original whitepaper <https://tendermint.com/static/docs/tendermint.pdf>`__, though it is now quite outdated.
 * Readers might also be interested in the `Cosmos Whitepaper <https://cosmos.network/whitepaper>`__ which describes Tendermint, ABCI, and how to build a scalable, heterogeneous, cryptocurrency network.