Issue #269 update actionkit connector docs

[rgriff23]

This PR updates connector documentation for the ActionKit class, per issue #269.

Change summary:

• Updated the overview and quickstart in the *.rst, aiming to following the examples provided in the issue description as closely as possible
• Fixed a couple typos in the main docstring for the class
• Cleaned up **kwargs documentation, making it consistent and correct across functions

All tests passed

[rgriff23]

I based my changes off existing examples, but I'm not sure if my *.rst formatting is correct. Is there a good way to check the impact of the changes?

[shaunagm]

@rgriff23 there should be a way to build the docs locally and inspect your changes there, but it's not been written down yet (and I personally don't know it). For now the docs just link to the sphinx guide for rebuilding but I wasn't able to get that working myself so I'm not sure how helpful it will be. Hopefully @eliotst or @SorenSpicknall can get us the right process.

At least on a content level, your updates look fantastic. We finally have our "model connector docs" we can point to and say "make your documentation look like this!"

[jburchard]

For creating docs internally you need two packages:

Sphinx==1.8.3
sphinx-rtd-theme==0.4.2

Then to build do the following:

> cd docs
> make html

It will generate all of the html locally that you can then inspect. If there are recommendations as to how to better systematize this, I'm open to it. The html files shouldn't be included in the commit though, as they are built on deploy.

[eliotst]

This is great! Thank you so much for making these changes. Just a couple of small things.

[eliotst]

One small thing: we capitalize "Parsons" when referencing the name of the library in documentation.

[eliotst]

Another minor thing.. could you wrap the environment variables' names in double backticks (e.g. ``ACTION_KIT_DOMAIN``) so they are formatted as code?

[eliotst]

Thanks again!

[shaunagm]

Thanks so much @rgriff23! I updated issue 269 to use the actionkit connector as the new model. :)

[rgriff23]

For creating docs internally you need two packages:

Sphinx==1.8.3
sphinx-rtd-theme==0.4.2

Then to build do the following:

> cd docs
> make html

It will generate all of the html locally that you can then inspect. If there are recommendations as to how to better systematize this, I'm open to it. The html files shouldn't be included in the commit though, as they are built on deploy.

@jburchard @shaunagm I also had to install m2r for this to work