Updated README (more general instructions) and docs config (typo fixes)

Cosmetic changes.

NOTE: Despite the changes `pip install https://...` is (still) not working on OS X using pip 1.5.4 with python 2.7.8 due to a `UnicodeDecodeError` in pip. Thank heaven, `python setup.py install` installs fine.
```
Exception:
Traceback (most recent call last):
  File "(...virtualenv...)/lib/python2.7/site-packages/pip/basecommand.py", line 122, in main
    status = self.run(options, args)
  File "(...virtualenv...)/lib/python2.7/site-packages/pip/commands/install.py", line 278, in run
    requirement_set.prepare_files(finder, force_root_egg_info=self.bundle, bundle=self.bundle)
  File "(...virtualenv...)/lib/python2.7/site-packages/pip/req.py", line 1197, in prepare_files
    do_download,
  File "(...virtualenv...)/lib/python2.7/site-packages/pip/req.py", line 1375, in unpack_url
    self.session,
  File "(...virtualenv...)/lib/python2.7/site-packages/pip/download.py", line 582, in unpack_http_url
    unpack_file(temp_location, location, content_type, link)
  File "(...virtualenv...)/lib/python2.7/site-packages/pip/util.py", line 621, in unpack_file
    unzip_file(filename, location, flatten=not filename.endswith(('.pybundle', '.whl')))
  File "(...virtualenv...)/lib/python2.7/site-packages/pip/util.py", line 499, in unzip_file
    fn = os.path.join(location, fn)
  File "(...virtualenv...)/bin/../lib/python2.7/posixpath.py", line 80, in join
    path += '/' + b
UnicodeDecodeError: 'ascii' codec can't decode byte 0xc4 in position 31: ordinal not in range(128)
```