docs: prettify & organize

docs/ibc.rst

@@ -1,5 +1,5 @@
-InterBlockchain Communication with the Cosmos SDK
-=================================================
+IBC
+===
 
 TODO: update in light of latest SDK (this document is currently out of date)
 
@@ -18,8 +18,8 @@ serialized IBC transaction type.
 
 We'll demonstrate exactly how this works below.
 
-IBC
----
+Inter BlockChain Communication
+------------------------------
 
 Let's review the IBC protocol. The purpose of IBC is to enable one
 blockchain to function as a light-client of another. Since we are using

docs/index.rst

@@ -14,11 +14,14 @@ Welcome to the Cosmos SDK!
 SDK
 ---
 
+.. One maxdepth for now
+
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
    
    sdk/overview.rst
    sdk/install.rst
+   sdk/glossary.rst
 
 .. Basecoin
 .. --------
@@ -52,8 +55,9 @@ Staking Module
 Extras
 ------
 
+.. One maxdepth for now
+
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    ibc.rst
-   glossary.rst

docs/sdk/overview.rst

@@ -118,6 +118,7 @@ Capabilities systems
 ~~~~~~~~~~~~~~~~~~~~
 
 TODO:
+
 * Need for module isolation
 * Capability is implied permission
 * Link to thesis
@@ -126,7 +127,7 @@ Tx & Msg
 ~~~~~~~~
 
 The SDK distinguishes between transactions (Tx) and messages
-(Msg).  A Tx is a Msg wrapped with authentication and fee data.
+(Msg). A Tx is a Msg wrapped with authentication and fee data.
 
 Messages
 ^^^^^^^^
@@ -319,6 +320,7 @@ Mounting an IAVLStore
 ^^^^^^^^^^^^^^^^^^^^^
 
 TODO:
+
 * IAVLStore: Fast balanced dynamic Merkle store.
 
   * supports iteration.