Skip to content

Commit ab3e82d

Browse files
authored
Adds links to Python Discourse and ruff to typing.readthedocs.io (#1774)
I noticed that the "Discussions and Support" section still linked to the typing-sig mailing list. While touching this page, I figured I might as well add ruff, which is used by typeshed, to the list of linters, and make the items in each list grammatically consistent.
1 parent 20efe7b commit ab3e82d

File tree

1 file changed

+15
-8
lines changed

1 file changed

+15
-8
lines changed

docs/index.rst

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,8 @@ Discussions and Support
5454

5555
* `User help forum <https://github.com/python/typing/discussions>`_
5656
* `User chat on Gitter <http://gitter.im/python/typing>`_
57-
* `Developer mailing list <https://mail.python.org/archives/list/[email protected]/>`_
57+
* `Developer forum <https://discuss.python.org/c/typing/32>`_
58+
* `Developer mailing list (archived) <https://mail.python.org/archives/list/[email protected]/>`_
5859

5960
Typing-related Tools
6061
====================
@@ -64,12 +65,12 @@ Type Checkers
6465

6566
* `mypy <http://mypy-lang.org/>`_, the reference implementation for type
6667
checkers.
67-
* `pyre <https://pyre-check.org/>`_, written in OCaml and optimized for
68-
performance.
68+
* `pyre <https://pyre-check.org/>`_, a type checker written in OCaml and
69+
optimized for performance.
6970
* `pyright <https://github.com/microsoft/pyright>`_, a type checker that
7071
emphasizes speed.
71-
* `pytype <https://google.github.io/pytype/>`_, checks and infers types for
72-
unannotated code.
72+
* `pytype <https://google.github.io/pytype/>`_, a type checker that
73+
checks and infers types for unannotated code.
7374

7475
Development Environments
7576
------------------------
@@ -89,13 +90,19 @@ Linters and Formatters
8990
* `flake8-pyi <https://github.com/ambv/flake8-pyi>`_, a plugin for the
9091
`flake8 <https://flake8.pycqa.org/>`_ linter that adds support for type
9192
stubs.
93+
* `ruff <https://astral.sh/ruff>`_, a linter built for speed, with support for
94+
most of the ``flake8-pyi`` rules.
9295

9396
Type-Hint and Stub Integration
9497
------------------------------
9598

96-
* `autotyping <https://github.com/JelleZijlstra/autotyping>`_, a tool which infers simple types from their context and inserts them as inline type-hints.
97-
* `merge_pyi <https://google.github.io/pytype/developers/tools.html#merge_pyi>`_, integrates .pyi signatures as inline type-hints in Python source code.
98-
This is a thin wrapper around ``ApplyTypeAnnotationsVisitor`` from `libCST <https://libcst.readthedocs.io/en/latest/>`_.
99+
* `autotyping <https://github.com/JelleZijlstra/autotyping>`_, a tool which
100+
infers simple types from their context and inserts them as inline type-hints.
101+
* `merge-pyi
102+
<https://google.github.io/pytype/developers/tools.html#merge_pyi>`_,
103+
a thin wrapper around ``ApplyTypeAnnotationsVisitor`` from
104+
`libCST <https://libcst.readthedocs.io/en/latest/>`_ that integrates .pyi
105+
signatures as inline type-hints in Python source code.
99106

100107
Typing PEPs
101108
===========

0 commit comments

Comments
 (0)