Fixes #451.

[ci skip]

[ci skip]

Use the new PyPI at https://pypi.org/.

[ci skip]

[ci skip]

Fix for #442 issue

`pkg_resources.SetuptoolsVersion` got deprecated in `setuptools` `v39.0.0`.
Moved on using stable and recommended `pkg_resources.parse_version`
function that does the same. For more details on the topic
see http://setuptools.readthedocs.io/en/latest/history.html#v39-0-0.

[ci skip]

[ci skip]

Correctly detect upgrade with extension that depends on setuptools

With an extension (like mr.developer) that depends on setuptools *and* with
the new update-the-workingset-immediately functionality introduced in 2.11,
the old have-we-been-upgraded-ourselves functionality didn't function reliably
anymore.

Clarify intent plus spelling/grammar fixes

Highlight names uniformly

Fix a typo, minor grammar issues

properly close resources

Fixes ``buildout.py:574: ResourceWarning: unclosed file <_io.TextIOWrapper...>```

Highlight option and folder names with backticks, in order to be uniform throughout the document.

[ci skip]

[ci skip]

Fix race condition with working set not reflecting reality during integrity check.

may conflict with new eggs buildout is trying to install.

[ci skip]

[ci skip]

Added sorting of working set used by zc.recipe.egg

[ci skip]

[ci skip]

Install wheels via setuptools, fixes #425