This is basically a revert of commit:
  af741ec2236619880fa902d68aef4a6ae6cef534

It was decided that only files that need to have the line:
  # -*- coding: utf-8 -*-
Should have the line[1] as a general principle

This patch removes the 'utf-8' coding line from files that consist
entirely of ASCII characters.

[1]
http://eavesdrop.openstack.org/meetings/ironic/2015/ironic.2015-04-20-17.00.html

Partial-bug: #1325193
Change-Id: I88c1c37f7b580aa805eae9d4a1e66d33302a325f

Remove intersphinx from the docs build as it triggers network calls that
occasionally fail, and we don't really use intersphinx (links other
sphinx documents out on the internet)

This also removes the requirement for internet access during docs build.

This can cause docs jobs to fail if the project errors out on
warnings.

Change-Id: I71e941e2a639641a662a163c682eb86d51de42fb
Related-Bug: #1368910

This adds the main ('index') page for developers (to be available
at http://docs.openstack.org/developer/python-ironicclient/).
It has minimal information, and is a place holder so that we can
start adding documentation.

This also fixes issues with 'python setup.py build_sphinx':
- was getting "error: 'source_dir' must be a directory name"
  because sphinx 1.2b3 was being installed instead of 1.1.2
  (see https://bugs.launchpad.net/openstack-ci/+bug/1259511)
- was getting "sphinx.errors.ExtensionError: Could not import
  extension oslo.sphinx (exception: No module named sphinx)"
- was complaining about missing '_theme' (oslosphinx has the theme)

Change-Id: I47ad7e10c20b80a99ae36755b2f7f67c080676fd
Partial-Bug: #1300990

Add initial files to the repo.

Change-Id: Ia6b0278fc9817f44e63507b54e7d7ad41bf4e219