* Formatting, clarify phrasing

Pulling out this functionality in its own paragraph, spelling out the name of the character (dash) and adding an example makes this feature more visible.

Might help with #870

* rst is not markdown

* Fix formatting

- print link to where documentation is generated
- remove old documentation css
- configure alabaster to display Github stars/Travis CI, and fork me badge
- allow the documentation to span up to 1280 pixels, instead of 800 (this allows many code examples to be much more readable, or changelog entries)
- remove large spaces in between changelog entries for a more compact view
- version strings are italic and bold for a cleaner delimitation inside the changelog
- sections in a version changelog has a smaller top margin for a more compact view
- automatically render news at top of the documentation under DRAFT section, this allows testing the news fragment before release
- remove double header for changelog 
- use the ``:user:`` extlinks for changelog entries to link to contributors
Github profile
- improve changelog entry for issue #858
- add a config file for readthedocs

see example output at https://tox-gaborbernat.readthedocs.io/en/doc-impr (or deep dive http://tox-gaborbernat.readthedocs.io/en/doc-impr/changelog.html)

* docs: remove "links" from toctree

Fixes a warning with Sphinx after 1.7.5 [1]:

> …/tox/doc/index.rst:99:toctree contains reference to
> document 'links' that doesn't have a title: no link will be generated

1: https://github.com/sphinx-doc/sphinx/commit/285ae7e881c31043592c8aeb62770ac362d57098

* tox.ini: docs: no need to whitelist sphinx-build

* Add 'ignore_basepython_conflict' option (#477)

tox provides a number of default factors - py27, py34, py35 etc. - that
are tied to particular interpreter versions. It is possible to override
these through individual sections or the global [testenv] section. For
example, consider the following 'tox.ini' file:

  [tox]
  skipsdist = True
  minversion = 2.0
  distribute = False
  envlist = py35,py27,pep8,py34-test

  [testenv]
  basepython = python3
  install_command = pip install {opts} {packages}
  commands =
    python --version

  [testenv:py27]
  basepython = python2.7

Running any target except for 'py27' will result in the same interpreter
being used. On Fedora 28 with the 'python3-tox' package:

  $ tox -qq -e py27
  Python 2.7.15
  $ tox -qq -e py35
  Python 3.6.5
  $ tox -qq -e py34-test
  Python 3.6.5

This is broken by design. Overriding these makes no sense and is a
source of common misconfigurations, as noted in #477. The only sane
thing to do here is ignore the request and use the correct interpreter
or raise a warning. There is merit to both approaches, so this
functionality is exposed by way of a new global configuration option,
'ignore_basepython_conflict'.

This shows nice syntax highlight in the generated docs

Hi friends, I made a terrific (terrible? terrifying?) thing.

I needed one manual `,` addition to the `setup.py` example so it could be parsed -- otherwise this is fully automated!

Using the new thing I made today: https://github.com/asottile/blacken-docs

Heavily inspired by pytest-dev/pytest#3525.  See also ambv/black#292, ambv/black#294. 

Committed via https://github.com/asottile/all-repos

:+1: more checks and formats

* add automatic code format enforcer - black
* convert % to format
* fix double quotes in one line
* some more % to format changes
* use stable release of black
* allow unicode in description