Further modifications to the module formatter to adjust to the new theme, and some misc docs text corrections.

You need to source hacking/env-setup before running hacking/test-module;
otherwise you get an error like this:

    ImportError: No module named ansible.utils

  Migrated all examples: in DOCUMENTATION=''' string to standalone EXAMPLES=''' string
  Added deprecation warning to moduledev.rst and remove deprecated example from it
  Fixed up a few typos and uppercased some acronyms.
  add consistency to how EXAMPLES are formatted

Fixes #2410

Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

return DOC and EXAMPLES as a list
add moduledev explanation
more

  add ./hacking/