Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refresh README.md, CONTRIBUTING.md #11413

Merged
merged 2 commits into from Oct 31, 2021
Merged

Refresh README.md, CONTRIBUTING.md #11413

merged 2 commits into from Oct 31, 2021

Conversation

@hauntsaninja
Copy link
Collaborator

@hauntsaninja hauntsaninja commented Oct 31, 2021

This was prompted by #11403

Changes include:

  • General streamlining of markdown
  • Remove outdated references, e.g. to Python 2 / how to install Python 3
  • Mention the "type school" discussions repo, typing-sig mailing list
  • Remove roadmap, since there isn't really a mypy core team anymore
  • More concretely link to "good first issue" page, etc. Hopefully this
    is a better experience than the somewhat common case of gitter posts
    like "I know Python, please help me contribute" that don't
    really go anywhere
  • Consolidate contributing information in CONTRIBUTING.md
  • Remove issue tracker conventions, since the template does a pretty
    good job and the rest is either common sense or never looked at
This was prompted by python#11403

Changes include:
- General streamlining of markdown
- Remove outdated references, e.g. to Python 2 / how to install Python 3
- Mention the "type school" discussions repo, typing-sig mailing list
- Remove roadmap, since there isn't really a mypy core team anymore
- More concretely link to "good first issue" page, etc. Hopefully this
  is a better experience than the somewhat common case of gitter posts
  like "I know Python, please help me contribute" that don't
  really go anywhere
- Consolidate contributing information in CONTRIBUTING.md
- Remove issue tracker conventions, since the template does a pretty
  good job and the rest is either common sense or never looked at
Copy link
Collaborator

@TH3CHARLie TH3CHARLie left a comment

Nice refreshment! Thanks for doing this!

CREDITS Outdated Show resolved Hide resolved
Co-authored-by: Xuanda Yang <th3charlie@gmail.com>
@hauntsaninja hauntsaninja merged commit 3d82f6f into python:master Oct 31, 2021
4 checks passed
@hauntsaninja hauntsaninja deleted the mdmd branch Oct 31, 2021
@pranavrajpal
Copy link
Contributor

@pranavrajpal pranavrajpal commented Nov 3, 2021

One other change that I'd like to see that's related to this is making the developer documentation more prominent. Right now, the link to the developer documentation is barely mentioned once at the bottom of CONTRIBUTING.md, which makes it very easy to not notice that it exists unless you're specifically looking for developer documentation.

I think we could improve this by moving that link to either the top of CONTRIBUTING.md or the Contributing section of the README.

@TH3CHARLie
Copy link
Collaborator

@TH3CHARLie TH3CHARLie commented Nov 3, 2021

very reasonable, feel free to make a PR

tushar-deepsource added a commit to deepsourcelabs/mypy that referenced this issue Jan 20, 2022
This was prompted by python#11403

Changes include:
- General streamlining of markdown
- Remove outdated references, e.g. to Python 2 / how to install Python 3
- Mention the "type school" discussions repo, typing-sig mailing list
- Remove roadmap, since there isn't really a mypy core team anymore
- More concretely link to "good first issue" page, etc. Hopefully this
    is a better experience than the somewhat common case of gitter posts
    like "I know Python, please help me contribute" that don't
    really go anywhere
- Consolidate contributing information in CONTRIBUTING.md
- Remove issue tracker conventions, since the template does a pretty
    good job and the rest is either common sense or never looked at
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Linked issues

Successfully merging this pull request may close these issues.

None yet

3 participants