=htp move docs and create TOC structure

akka-docs-dev/rst/scala/http-core/index.rst

@@ -1,10 +0,0 @@
-Low-level HTTP API
-==================
-
-.. toctree::
-   :maxdepth: 2
-
-   model
-   server
-   client
-   https

akka-docs-dev/rst/scala/http-testkit/testkit.rst

@@ -1,2 +0,0 @@
-HTTP Testkit
-============

akka-docs-dev/rst/scala/http/index-client-server.rst

@@ -0,0 +1,12 @@
+.. _http-client-server-scala:
+
+HTTP Client & Server
+====================
+
+.. toctree::
+   :maxdepth: 2
+
+   model
+   client
+   server
+   https

akka-docs-dev/rst/scala/http/index-routing.rst

@@ -0,0 +1,18 @@
+.. _http-routing-index-scala:
+
+HTTP Routing
+============
+ 
+.. toctree::
+   :maxdepth: 2
+ 
+   quick-start
+   routing
+   directives
+   rejections
+   exception-handling
+   path-matchers
+   marshalling
+   directives/alphabetically
+   directives/by-trait
+

akka-docs-dev/rst/scala/http/index-testkit.rst

@@ -0,0 +1,8 @@
+.. _http-testkit-scala:
+
+HTTP TestKit
+============
+
+.. note::
+
+   This part of the documentation has not yet been written, please stay tuned for updates.

akka-docs-dev/rst/scala/http/index.rst

@@ -1,17 +1,28 @@
-High-level HTTP API
-===================
+.. _http-scala:
+
+Akka HTTP
+=========
+
+The purpose of the Akka HTTP layer is to expose Actors to the web via HTTP and
+to enable them to consume HTTP services as a client. It is not an HTTP
+framework, it is an Actor-based toolkit for interacting with web services and
+clients. This toolkit is structured into several layers:
+
+  * ``akka-http-core``: A complete implementation of the HTTP standard, both as
+    client and server.
+
+  * ``akka-http``: A convenient and powerful routing DSL for expressing web
+    services.
+
+  * ``akka-http-testkit``: A test harness and set of utilities for verifying
+    your web service implementations.
+
+Additionally there are several integration modules with bindings for different
+serialization and deserialization schemes for HTTP entities.
 
 .. toctree::
    :maxdepth: 2
 
-   quick-start
-   routing
-   directives
-   rejections
-   exception-handling
-   path-matchers
-   marshalling
-   directives/alphabetically
-   directives/by-trait
-
-
+   index-client-server
+   index-routing
+   index-testkit