docs(newsfragments): clean up newandimproved up to #2110

Author: vytas7

docs/_newsfragments/1947.newandimproved.rst

@@ -1,4 +1,4 @@
-Basic typing annotations have been added to the most commonly used functions of
-Falcon's public interface to the package itself in order to better support
-`mypy <https://www.mypy-lang.org/>`_ users without having to install any
-third-party typeshed packages.
+Type annotations have been added to Falcon's public interface to the package
+itself in order to better support `Mypy <https://www.mypy-lang.org/>`__
+(or other type checkers) users without having to install any third-party
+typeshed packages.

docs/_newsfragments/2023.newandimproved.rst

@@ -1,4 +1,4 @@
 The default error serializer will now use the response media handlers
-to better negotiate the response serialization with the client.
+to better negotiate the response content type with the client.
 The implementation still defaults to JSON if the client does not indicate any
 preference.

docs/_newsfragments/228.newandimproved.rst

@@ -1,2 +1,4 @@
-Add link-extension to :meth:`falcon.Response.append_link` as specified in
-`RFC 8288 Sec. 3.4.2 <https://datatracker.ietf.org/doc/html/rfc8288#section-3.4.2>`__.
+A new keyword argument, `link_extension`, was added to
+:meth:`falcon.Response.append_link` as specified in
+`RFC 8288, Section 3.4.2
+<https://datatracker.ietf.org/doc/html/rfc8288#section-3.4.2>`__.

falcon/response.py

@@ -898,10 +898,9 @@ def append_link(
                 Can take values 'anonymous' or 'use-credentials' or None.
                 (See:
                 https://www.w3.org/TR/html50/infrastructure.html#cors-settings-attribute)
-            link_extension(iterable): Provides additional custom attributes, as
-                described in RFC 8288, Section 3.4.2. Each member of the iterable
+            link_extension: Provides additional custom attributes, as
+                described in RFC 8288, Section 3.4.2; each member of the iterable
                 must be a two-tuple in the form of (*param*, *value*).
-                (See: https://datatracker.ietf.org/doc/html/rfc8288#section-3.4.2)
 
         """