Document convention on compat modules #145
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR is a follow up on the discussion in pypa/setuptools#4609 (the same changes as presented in setuptools, largely borrowed from the initial comments in pypa/setuptools#4212 and slightly tweaked).
I have not expanded on the why
compat
instead of_compat
(the rationale is presented in pypa/setuptools#4609 (comment)), but I can try to add something regarding that too.I have not added anything yet about extracting reusable shims to
jaraco.compat
, but that can also be added if necessary.