getting started page

docs/getting-started.rst

@@ -0,0 +1,68 @@
+.. _getting-started:
+
+===============
+Getting Started
+===============
+
+You won't be going too far without :ref:`installation` unless you're just here
+to read.
+
+
+How these Docs are Arranged
+---------------------------
+
+Topics
+~~~~~~
+
+These are fairly broad narratives that cover things like Django or Sphinx, with
+lots of links to more in-depth coverage.
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    topics/*
+
+
+Reference
+~~~~~~~~~
+
+Reference pages are more like typical API docs, using docstrings and narratives
+to cover internal packages.
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    ref/*
+
+
+
+Things to learn about:
+
+Django
+    * ORM
+    * CSRF
+    * Forms
+    * testing
+    * best practices, app layout
+    * multidb, master-slave
+
+Jinja
+    * builtin filters
+    * :mod:`jingo`
+
+Sphinx
+    * basic syntax
+    * referencing modules
+
+
+Things that need work
+
+* finding translation strings & context
+* fetching translations
+* where to put jinja extensions
+* caching
+* continuous integration
+* nose testing
+* production

docs/index.rst

@@ -27,6 +27,7 @@ Contents:
    :maxdepth: 2
    :glob:
 
+   getting-started
    installation
    ref/*