@@ -25,9 +25,11 @@ break, but they are more likely not to. Having a version off pip <9.0 can lead
2525your system to try to upgrade to non-compatible versions of Python packages
2626even if these are marked as non-compatible.
2727
28- Make as many other_ users_ as possible to install pip >=9.0, for the
28+ Help as many other_ users_ as possible to install pip >=9.0, for the
2929transition, it is the slowest part of the ecosystem to update, and is the only
30- piece that concern all all installations.
30+ piece that concerns all installations:
31+
32+ pip install --upgrade setuptools pip
3133
3234##Setuptools
3335
@@ -38,8 +40,9 @@ might fail, even on Python 2.
3840##Local package index
3941
4042If you are using a custom local package index, for example if you are working
41- at a company with private packages, make sure it implement correctly pep-503
42- and let pip knows about the` python_requires ` field.
43+ at a company with private packages, make sure it implement correctly
44+ [ pep-503] ( https://www.python.org/dev/peps/pep-0503/ ) and let pip knows about
45+ the` python_requires ` field.
4346
4447##The state of PyPI
4548
9699
97100- Add an error early at import at runtime with a clear error message, leave the
98101 early import compatible Python 2 for users to not be welcomed with a useless` SyntaxError ` .
99- You are_ allowed_ to usemultiline strings in error messages.
102+ You are_ allowed_ to usemulti-line strings in error messages.
100103
101104
102105```
@@ -113,7 +116,7 @@ bummer sorry about that it should not have happen. Make sure you have pip >=
113116
114117 $ pip install pip --upgrade
115118
116- Use thefollowign to check pip version
119+ Use thefollowing to check pip version
117120
118121You have various choices:
119122
@@ -142,7 +145,7 @@ This this page for more information : url to here for example.
142145
143146
144147
145- #Recommende Mitigations
148+ #Recommended Mitigations
146149
147150Of course regardless of all the care you will take for your library to no break
148151and to install only on python 2, you will likely have cases where it still end
@@ -159,21 +162,20 @@ the all update process broken.
159162 dependencies depending on the version of Python.
160163
161164
162- #Non recommended mitigation
165+ #Alternative mitigation
163166
164167This is a collection of "mitigation" or "solutions" you will find on the web
165- and that you will hear about. This is an attempt toacknowlege them, and
168+ and that you will hear about. This is an attempt toacknowledge them, and
166169explain why they can't work and what are their drawbacks before you attempt to
167170implement them.
168171
169172### Use a meta-package.
170173
171174
172175
173-
174176# Why all that ?
175177
176- You might wonder why allthi , it's 2016 already, so how come all these issues ?
178+ You might wonder why allthis , it's 2016 already, so how come all these issues ?
177179Python 3 has been out for 8+ years now !
178180
179181Well there are many reasons to this,