Add sphinx reference for whatsnew 3.3 (#10564)

Author: cdce8p

doc/whatsnew/3/3.3/index.rst

@@ -24,16 +24,16 @@ For details, see: https://github.com/pylint-dev/pylint/pull/10482#issuecomment-3
 False Positives Fixed
 ---------------------
 
-- Fix false positives for `possibly-used-before-assignment` when variables are exhaustively
- assigned within a `match` block.
+- Fix false positives for :ref:`possibly-used-before-assignment` when variables are exhaustively
+ assigned within a :keyword:`match` block.
 
  Closes #9668 (`#9668 <https://github.com/pylint-dev/pylint/issues/9668>`_)
 
-- Fix false positive for `missing-raises-doc` and `missing-yield-doc` when the method length is less than docstring-min-length.
+- Fix false positive for :ref:`missing-raises-doc` and :ref:`missing-yield-doc` when the method length is less than docstring-min-length.
 
  Refs #10104 (`#10104 <https://github.com/pylint-dev/pylint/issues/10104>`_)
 
-- Fix a false positive for ``unused-variable`` when multiple except handlers bind the same name under a try block.
+- Fix a false positive for :ref:`unused-variable` when multiple except handlers bind the same name under a try block.
 
  Closes #10426 (`#10426 <https://github.com/pylint-dev/pylint/issues/10426>`_)
 
@@ -42,7 +42,7 @@ False Positives Fixed
 False Negatives Fixed
 ---------------------
 
-- Fix false-negative for ``used-before-assignment`` with ``from __future__ import annotations`` in function definitions.
+- Fix false-negative for :ref:`used-before-assignment` with ``from __future__ import annotations`` in function definitions.
 
  Refs #10482 (`#10482 <https://github.com/pylint-dev/pylint/issues/10482>`_)
 
@@ -69,7 +69,7 @@ Release date: 2025-05-04
 False Positives Fixed
 ---------------------
 
-- Comparisons between two calls to `type()` won't raise an ``unidiomatic-typecheck`` warning anymore, consistent with the behavior applied only for ``==`` previously.
+- Comparisons between two calls to `type()` won't raise an :ref:`unidiomatic-typecheck` warning anymore, consistent with the behavior applied only for ``==`` previously.
 
  Closes #10161 (`#10161 <https://github.com/pylint-dev/pylint/issues/10161>`_)
 
@@ -86,7 +86,7 @@ Other Bug Fixes
 
  Closes #10282 (`#10282 <https://github.com/pylint-dev/pylint/issues/10282>`_)
 
-- Using a slice as a class decorator now raises a ``not-callable`` message instead of crashing. A lot of checks that dealt with decorators (too many to list) are now shortcut if the decorator can't immediately be inferred to a function or class definition.
+- Using a slice as a class decorator now raises a :ref:`not-callable` message instead of crashing. A lot of checks that dealt with decorators (too many to list) are now shortcut if the decorator can't immediately be inferred to a function or class definition.
 
  Closes #10334 (`#10334 <https://github.com/pylint-dev/pylint/issues/10334>`_)
 
@@ -95,7 +95,7 @@ Other Bug Fixes
 Other Changes
 -------------
 
-- The algorithm used for ``no-member`` suggestions is now more efficient and cuts the
+- The algorithm used for :ref:`no-member` suggestions is now more efficient and cuts the
  calculation when the distance score is already above the threshold.
 
  Refs #10277 (`#10277 <https://github.com/pylint-dev/pylint/issues/10277>`_)
@@ -110,7 +110,7 @@ Release date: 2025-03-20
 False Positives Fixed
 ---------------------
 
-- Fix a false positive for `used-before-assignment` when an inner function's return type
+- Fix a false positive for :ref:`used-before-assignment` when an inner function's return type
  annotation is a class defined at module scope.
 
  Closes #9391 (`#9391 <https://github.com/pylint-dev/pylint/issues/9391>`_)
@@ -125,16 +125,16 @@ Release date: 2025-03-09
 False Positives Fixed
 ---------------------
 
-- Fix false positives for `use-implicit-booleaness-not-comparison`, `use-implicit-booleaness-not-comparison-to-string`
- and `use-implicit-booleaness-not-comparison-to-zero` when chained comparisons are checked.
+- Fix false positives for :ref:`use-implicit-booleaness-not-comparison`, :ref:`use-implicit-booleaness-not-comparison-to-string`
+ and :ref:`use-implicit-booleaness-not-comparison-to-zero` when chained comparisons are checked.
 
  Closes #10065 (`#10065 <https://github.com/pylint-dev/pylint/issues/10065>`_)
 
-- Fix a false positive for ``invalid-getnewargs-ex-returned`` when the tuple or dict has been assigned to a name.
+- Fix a false positive for :ref:`invalid-getnewargs-ex-returned` when the tuple or dict has been assigned to a name.
 
  Closes #10208 (`#10208 <https://github.com/pylint-dev/pylint/issues/10208>`_)
 
-- Remove `getopt` and `optparse` from the list of deprecated modules.
+- Remove :py:mod:`getopt` and :py:mod:`optparse` from the list of deprecated modules.
 
  Closes #10211 (`#10211 <https://github.com/pylint-dev/pylint/issues/10211>`_)
 
@@ -143,15 +143,15 @@ False Positives Fixed
 Other Bug Fixes
 ---------------
 
-- Fixed conditional import x.y causing false positive possibly-used-before-assignment.
+- Fixed conditional import x.y causing false positive :ref:`possibly-used-before-assignment`.
 
  Closes #10081 (`#10081 <https://github.com/pylint-dev/pylint/issues/10081>`_)
 
 - Fix a crash when something besides a class is found in an except handler.
 
  Closes #10106 (`#10106 <https://github.com/pylint-dev/pylint/issues/10106>`_)
 
-- Fixed raising invalid-name when using camelCase for private methods with two leading underscores.
+- Fixed raising :ref:`invalid-name` when using camelCase for private methods with two leading underscores.
 
  Closes #10189 (`#10189 <https://github.com/pylint-dev/pylint/issues/10189>`_)
 
@@ -196,13 +196,13 @@ Release date: 2024-12-23
 False Positives Fixed
 ---------------------
 
-- Fix false positives for ``undefined-variable`` for classes using Python 3.12
+- Fix false positives for :ref:`undefined-variable` for classes using Python 3.12
  generic type syntax.
 
  Closes #9335 (`#9335 <https://github.com/pylint-dev/pylint/issues/9335>`_)
 
-- Fix a false positive for `use-implicit-booleaness-not-len`. No lint should be emitted for
- generators (`len` is not defined for generators).
+- Fix a false positive for :ref:`use-implicit-booleaness-not-len`. No lint should be emitted for
+ generators (:py:func:`len` is not defined for generators).
 
  Refs #10100 (`#10100 <https://github.com/pylint-dev/pylint/issues/10100>`_)
 
@@ -225,7 +225,7 @@ Release date: 2024-12-01
 False Positives Fixed
 ---------------------
 
-- Fix a false positive for `potential-index-error` when an indexed iterable
+- Fix a false positive for :ref:`potential-index-error` when an indexed iterable
  contains a starred element that evaluates to more than one item.
 
  Closes #10076 (`#10076 <https://github.com/pylint-dev/pylint/issues/10076>`_)
@@ -275,7 +275,7 @@ Changes requiring user actions
 New Features
 ------------
 
-- Add new `declare-non-slot` error which reports when a class has a `__slots__` member and a type hint on the class is not present in `__slots__`.
+- Add new :ref:`declare-non-slot` error which reports when a class has a `__slots__` member and a type hint on the class is not present in `__slots__`.
 
  Refs #9499 (`#9499 <https://github.com/pylint-dev/pylint/issues/9499>`_)
 
@@ -284,7 +284,7 @@ New Features
 New Checks
 ----------
 
-- Added `too-many-positional-arguments` to allow distinguishing the configuration for too many
+- Added :ref:`too-many-positional-arguments` to allow distinguishing the configuration for too many
  total arguments (with keyword-only params specified after `*`) from the configuration
  for too many positional-or-keyword or positional-only arguments.
 
@@ -293,24 +293,24 @@ New Checks
 
  Closes #9099 (`#9099 <https://github.com/pylint-dev/pylint/issues/9099>`_)
 
-- Add `using-exception-groups-in-unsupported-version` and
- `using-generic-type-syntax-in-unsupported-version` for uses of Python 3.11+ or
- 3.12+ features on lower supported versions provided with `--py-version`.
+- Add :ref:`using-exception-groups-in-unsupported-version` and
+ :ref:`using-generic-type-syntax-in-unsupported-version` for uses of Python 3.11+ or
+ 3.12+ features on lower supported versions provided with ``--py-version``.
 
  Closes #9791 (`#9791 <https://github.com/pylint-dev/pylint/issues/9791>`_)
 
-- Add `using-assignment-expression-in-unsupported-version` for uses of `:=` (walrus operator)
- on Python versions below 3.8 provided with `--py-version`.
+- Add :ref:`using-assignment-expression-in-unsupported-version` for uses of ``:=`` (walrus operator)
+ on Python versions below 3.8 provided with ``--py-version``.
 
  Closes #9820 (`#9820 <https://github.com/pylint-dev/pylint/issues/9820>`_)
 
-- Add `using-positional-only-args-in-unsupported-version` for uses of positional-only args on
- Python versions below 3.8 provided with `--py-version`.
+- Add :ref:`using-positional-only-args-in-unsupported-version` for uses of positional-only args on
+ Python versions below 3.8 provided with ``--py-version``.
 
  Closes #9823 (`#9823 <https://github.com/pylint-dev/pylint/issues/9823>`_)
 
-- Add ``unnecessary-default-type-args`` to the ``typing`` extension to detect the use
- of unnecessary default type args for ``typing.Generator`` and ``typing.AsyncGenerator``.
+- Add :ref:`unnecessary-default-type-args` to the ``typing`` extension to detect the use
+ of unnecessary default type args for :py:class:`typing.Generator` and :py:class:`typing.AsyncGenerator`.
 
  Refs #9938 (`#9938 <https://github.com/pylint-dev/pylint/issues/9938>`_)
 
@@ -319,25 +319,25 @@ New Checks
 False Negatives Fixed
 ---------------------
 
-- Fix computation of never-returning function: `Never` is handled in addition to `NoReturn`, and priority is given to the explicit `--never-returning-functions` option.
+- Fix computation of never-returning function: :py:class:`typing.Never` is handled in addition to :py:class:`typing.NoReturn`, and priority is given to the explicit `--never-returning-functions` option.
 
  Closes #7565. (`#7565 <https://github.com/pylint-dev/pylint/issues/7565>`_)
 
-- Fix a false negative for `await-outside-async` when await is inside Lambda.
+- Fix a false negative for :ref:`await-outside-async` when await is inside Lambda.
 
  Refs #9653 (`#9653 <https://github.com/pylint-dev/pylint/issues/9653>`_)
 
-- Fix a false negative for ``duplicate-argument-name`` by including ``positional-only``, ``*args`` and ``**kwargs`` arguments in the check.
+- Fix a false negative for :ref:`duplicate-argument-name` by including ``positional-only``, ``*args`` and ``**kwargs`` arguments in the check.
 
  Closes #9669 (`#9669 <https://github.com/pylint-dev/pylint/issues/9669>`_)
 
-- Fix false negative for `multiple-statements` when multiple statements are present on `else` and `finally` lines of `try`.
+- Fix false negative for :ref:`multiple-statements` when multiple statements are present on :keyword:`else` and :keyword:`finally` lines of :keyword:`try`.
 
  Refs #9759 (`#9759 <https://github.com/pylint-dev/pylint/issues/9759>`_)
 
-- Fix false negatives when `isinstance` does not have exactly two arguments.
- pylint now emits a `too-many-function-args` or `no-value-for-parameter`
- appropriately for `isinstance` calls.
+- Fix false negatives when :py:func::`isinstance` does not have exactly two arguments.
+ pylint now emits a :ref:`too-many-function-args` or :ref:`no-value-for-parameter`
+ appropriately for :py:func:`isinstance` calls.
 
  Closes #9847 (`#9847 <https://github.com/pylint-dev/pylint/issues/9847>`_)