docs: organize the directory, #656

docs/app-architecture.rst

@@ -58,7 +58,7 @@ Tendermint Core RPC
 
 The concept is that the ABCI app is completely hidden from the outside
 world and only communicated through a tested and secured `interface
-exposed by the tendermint core <./rpc.html>`__. This interface
+exposed by the tendermint core <./specification/rpc.html>`__. This interface
 exposes a lot of data on the block header and consensus process, which
 is quite useful for externally verifying the system. It also includes
 3(!) methods to broadcast a transaction (propose it for the blockchain,

docs/specification.rst

@@ -7,14 +7,14 @@ Here you'll find details of the Tendermint specification. See `the spec repo <ht
 .. toctree::
    :maxdepth: 2
 
-   block-structure.rst
-   byzantine-consensus-algorithm.rst
-   configuration.rst
-   fast-sync.rst
-   genesis.rst
-   light-client-protocol.rst
-   merkle.rst
-   rpc.rst
-   secure-p2p.rst
-   validators.rst
-   wire-protocol.rst
+  specification/block-structure.rst
+  specification/byzantine-consensus-algorithm.rst
+  specification/configuration.rst
+  specification/fast-sync.rst
+  specification/genesis.rst
+  specification/light-client-protocol.rst
+  specification/merkle.rst
+  specification/rpc.rst
+  specification/secure-p2p.rst
+  specification/validators.rst
+  specification/wire-protocol.rst

docs/specification/light-client-protocol.rst

@@ -16,7 +16,7 @@ The objective of the light client protocol is to get a
 `block hash <./block-structure.html#block-hash>`__ where the commit
 includes a majority of signatures from the last known validator set.
 From there, all the application state is verifiable with `merkle
-proofs <./merkle-trees#iavl-tree>`__.
+proofs <./merkle.html#iavl-tree>`__.
 
 Properties
 ----------

docs/using-tendermint.rst

@@ -117,7 +117,7 @@ Configuration
 -------------
 
 Tendermint uses a ``config.toml`` for configutation. For details, see
-`the documentation <./configuration.html>`__.
+`the documentation <./specification/configuration.html>`__.
 
 Notable options include the socket address of the application
 (``proxy_app``), the listenting address of the tendermint peer