Merge pull request #294 from hypothesis/docs-adrs-tweaks

Docs adrs tweaks

docs/arch/adr-001.md → docs/developers/arch/adr-001.md

-ADR 1: Component architecture for sidebar application
+ADR 1: Component Architecture for Sidebar Application
 =====================================================
 
 Context
@@ -36,7 +36,7 @@ controllerAs). Angular JS 1.5x introduced [explicit
 support](https://docs.angularjs.org/guide/component) for this architecture via
 `.component()`.
 
-### Components in the client
+### Components in the Client
 
 The client historically used traditional Angular 1.x methods of passing data
 between parts of the UI - properties on the scope inherited by child scopes and

docs/arch/index.md → docs/developers/arch/index.rst

-Architecture decision records
+Architecture Decision Records
 =============================
 
 Here you will find documents which describe significant architectural decisions
@@ -6,6 +6,11 @@ made or proposed when developing the Hypothesis client. We record these in
 order to provide a reference for the history, motivation, and rationale for past
 decisions.
 
-See [the
-introduction in the "h" repository](https://github.com/hypothesis/h/blob/master/docs/arch/index.rst)
+See
+`the introduction in the h repository <https://github.com/hypothesis/h/blob/master/docs/arch/index.rst>`_
 for more details.
+
+.. toctree::
+   :maxdepth: 1
+
+   adr-001

docs/developers/index.rst

@@ -5,8 +5,9 @@ This section contains documentation for **developers** contributing code to
 the Hypothesis client.
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
 
    developing
    security
    envvars
+   arch/index