[Python-checkins] Doc: No need to use rst syntax in code comments. (GH-93102)

miss-islington webhook-mailer at python.org
Mon May 23 18:00:49 EDT 2022


https://github.com/python/cpython/commit/fd35be511a5845e887408189a06513063319f417
commit: fd35be511a5845e887408189a06513063319f417
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2022-05-23T15:00:34-07:00
summary:

Doc: No need to use rst syntax in code comments. (GH-93102)


And it raises `make suspicious` false positives.
(cherry picked from commit e739ff141680fd7e2a762cf98c4352c6c850af1f)

Co-authored-by: Julien Palard <julien at palard.fr>

files:
M Doc/whatsnew/3.11.rst

diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst
index ff94e45f77c70..12b4c22d54807 100644
--- a/Doc/whatsnew/3.11.rst
+++ b/Doc/whatsnew/3.11.rst
@@ -314,7 +314,7 @@ transforms a class, giving it :func:`dataclasses.dataclass`-like behaviors.
 
 For example::
 
-    # The ``create_model`` decorator is defined by a library.
+    # The create_model decorator is defined by a library.
     @typing.dataclass_transform()
     def create_model(cls: Type[T]) -> Type[T]:
         cls.__init__ = ...
@@ -322,7 +322,7 @@ For example::
         cls.__ne__ = ...
         return cls
 
-    # The ``create_model`` decorator can now be used to create new model
+    # The create_model decorator can now be used to create new model
     # classes, like this:
     @create_model
     class CustomerModel:



More information about the Python-checkins mailing list