tweak position & look of Requirements in rst
tweak APT's notes as per anhj's wish

return DOC and EXAMPLES as a list
add moduledev explanation
more

At the moment Ansible prefers yes/no for module booleans, however booleans in playbooks are still using True/False, rather than yes/no. This changes modifies boolean uses in playbooks (and man pages) to favor yes/no rather than True/False.

This change includes:

- Adaptation of documentation and examples to favor yes/no
- Modification to manpage output to favor yes/no (the docsite output already favors yes/no)

 Add HTML-escaping to code examples in rST tempate of module-formatter
 Add support for specifying port, addresses with phrases and attaching files
 Add support for custom headers and document version_added for new options
 X-Mailer header added :)
 protect empty address lists & attachment list, and add bcc

   ongoing work for the Booklet

 - fixed template (it was the template), adding indentation with Jinja2
 - added description of code examples to man-page template (was missing)
 - fixed fireball, cron, and debug module examples to confrom

- Uses HTML tables and Github-flavored code blocks (3 backticks)

- Updated man template accordingly
- seem to have left in illegal char in facter DOCUMENTATION...

- notes is now supported
- multiline code examples are now supported (HTML rendering was off)

  - .rst now supresses default if none is set (looks better in HTML)
  - .rst now handles empty options list
  - Fixed postgresql_user and mysql_user because YAML contained colons
  - docs for facter

  plus a small fix in rst.j2 template
  manpages generated & checked
  modules.html generated & checked

Various tweaking to get the module formatter to work for 'make docs' in the docs project.  Likely the templates for other module formatting types will have to change
by the time I'm done.