Adding some much needed seperate docs

[seemethere]

Responding to this:
#4

It's probably not fully what you want, but hey it's something.

[dbader]

Thanks for kicking things off here @seemethere! I think we need to set up a way for the API docs to be generated from docstrings in the source. I imagine the docs to be a combination of best practices / usage examples (currently in the FAQ) and the actual API docs.

I really like the Flask docs to give an example: http://flask.pocoo.org/docs/0.10/

[dbader]

Linking this to #4 – we can possible reuse some of the copy there.

Thank you – I'm closing this so we can keep the tracker clean of loose ends. Feel free to follow up (or make a separate issue) with more questions/discussion 😃