Merge "New python swiftclient doc"

doc/source/cli.rst

@@ -0,0 +1,29 @@
+===
+CLI
+===
+
+Top-level commands
+~~~~~~~~~~~~~~~~~~
+
+.. TODO
+   
+   delete
+   download
+   list
+   post
+   stat
+   upload
+   info/capabilities
+   tempurl
+   auth
+
+Prescriptive examples
+~~~~~~~~~~~~~~~~~~~~~
+
+.. TODO
+  
+   A "Hello World" example
+   uploading an object
+   creating a tempurl
+   listing the contents of a container
+   downloading an object

doc/source/index.rst

@@ -8,6 +8,8 @@ Developer Documentation
     :maxdepth: 2
 
     apis
+    cli
+    sdk
 
 Code-Generated Documentation
 ============================

doc/source/sdk.rst

@@ -0,0 +1,48 @@
+===
+SDK
+===
+
+Where to start?
+~~~~~~~~~~~~~~~
+
+.. TODO
+  
+   when to use SwiftService
+   when to use client.py
+
+SwiftService classes and methods
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. TODO
+  
+   docs for each method (autogen from docstrings?)
+
+Client classes and methods
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. TODO
+   
+   docs for each method (autogen from docstrings?)
+
+Guidelines for writing an app
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. TODO
+   
+   auth
+   how to use various features
+   when to use various features
+   pooling connections
+   concurrency
+   retries
+
+Prescriptive examples
+~~~~~~~~~~~~~~~~~~~~~
+
+.. TODO
+
+   A "Hello World" example
+   connecting
+   uploading an object
+   uploading a directory
+