diff --git a/pypdf/annotations/__init__.py b/pypdf/annotations/__init__.py
index 3ddf985697..208972d627 100644
--- a/pypdf/annotations/__init__.py
+++ b/pypdf/annotations/__init__.py
@@ -30,16 +30,16 @@
     # Export abstract base classes so that they are shown in the docs
     "AnnotationDictionary",
     "MarkupAnnotation",
-    # markup annotations
+    # Markup annotations
     "Ellipse",
     "FreeText",
     "Highlight",
     "Line",
-    "Link",
     "Polygon",
     "PolyLine",
     "Rectangle",
     "Text",
     # Non-markup annotations
+    "Link",
     "Popup",
 ]
diff --git a/pypdf/annotations/_base.py b/pypdf/annotations/_base.py
index f235acf3a8..2aff325aa1 100644
--- a/pypdf/annotations/_base.py
+++ b/pypdf/annotations/_base.py
@@ -11,9 +11,9 @@ def __init__(self) -> None:
 
         # "rect" should not be added here as PolyLine can automatically set it
         self[NameObject("/Type")] = NameObject("/Annot")
-        # The flags was NOT added to the constructor on purpose: We expect that
-        #   most users don't want to change the default. If they want, they
-        #   can use the property. The default is 0.
+        # The flags were NOT added to the constructor on purpose: We expect that
+        # most users don't want to change the default. If they do, they
+        # can use the property. The default is 0.
 
     @property
     def flags(self) -> AnnotationFlag: