Merge lp://qastaging/~rvb/maas/maas-doc-python into lp://qastaging/~maas-committers/maas/trunk

This is great, but I can't get the docs to render fully.

[1]

- @bin/flake8 $(sources) | \
- (fgrep -v "from maas.settings import *" || true)
+ @bin/flake8 $(sources) | (! grep -v "from maas.settings import *")

Use fgrep here because the pattern contains regex characters that
should not have their special meaning interpreted.

[2]

`make build` breaks for me:

  File ".../docs/conf.py", line 18, in <module>
    from django.core.management import setup_environ
  ImportError: No module named django.core.management

Adding the following line to the [sphinx] section in buildout fixed it
for me:

  eggs = ${django:eggs}

[3]

+extra-paths = ${buildout:extra-paths}

If you add the eggs line in [2] then perhaps s/buildout/django/.

[4]

+Other service interact with a MaaS Server using its :doc:`api`.

s/service/services/
s/Server/server/ ?

[5]

+Code
+====
+
+.. toctree::
+ models

This just generates a header, and I see a build warning:

  .../docs/index.rst:33: WARNING: toctree contains reference to
  nonexisting document u'models'

[6]

+ """A `MACAddress` represents a `Mac Address
+ <http://en.wikipedia.org/wiki/MAC_address>`_ attached to a `Node`.
+
+ """

Blank line. Trivial, I know :)

Ah, I forgot to add a file. I fixed the other stuff as well now that I've fixed my setup ;).

That's really cool. I especially like the [source] links.

[7]

+ """A `MACAddress` represents a `Mac Address

s/Mac/MAC/