Better Index page

Author: shabda

README.md

@@ -1,18 +1,18 @@
-Buidling APIs with Django, DRF, Apiary, CircleCI, Heroku and more
+ Building APIs with Django and Django Rest Framework
 ==================================================================
 
 [Read it online](http://books.agiliq.com/projects/django-api-polls-tutorial/)
 
 An opinionated guide to building APIs with modern tools.
-A retelling of Django tutorial with microservices and documentation driven development.
+
+
 
 Dramatis personæ
 ================
 
 * Python: A programming language
 * Django: A framework for Python
 * Django rest framework: A flexible toolkit for building APIs
-* Apiary: Your api is only as good as its documentation
 * CircleCI: Keeps your documentation and API in sync
 
 

docs/index.rst

@@ -1,7 +1,13 @@
-Building a Django polls API with DRF
+Building APIs with Django and Django Rest Framework
 ======================================================
 
-Contents:
+Building APIs with Django and DRF takes over where the Django tutorials stop.
+In the Django tutorials, you built a regular Django polls app. We will rebuild an API for a similar app.
+
+In the chapters to come, we will build a REST(ish) api with authorization, rate limiting, first with pure Django and then with DRF.
+We will cover testing, contious integration, documentation tools and API collaboration tools.
+
+Chapters:
 
 .. toctree::
    :maxdepth: 2
@@ -11,15 +17,20 @@ Contents:
    chapter2
    chapter3
    chapter4
-   chapter5
-   chapter6
-   Documenting-API-with-RAML
 
 
 
-Indices and tables
+Appendix
 ==================
 
+.. toctree::
+   :maxdepth: 2
+
+   postman
+   swagger
+   Documenting-API-with-RAML
+
+
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`