bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294)
diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst
index ddc796a..638e160 100644
--- a/Doc/reference/compound_stmts.rst
+++ b/Doc/reference/compound_stmts.rst
@@ -681,8 +681,14 @@
.. seealso::
- :pep:`3115` - Metaclasses in Python 3
+ :pep:`3115` - Metaclasses in Python 3000
+ The proposal that changed the declaration of metaclasses to the current
+ syntax, and the semantics for how classes with metaclasses are
+ constructed.
+
:pep:`3129` - Class Decorators
+ The proposal that added class decorators. Function and method decorators
+ were introduced in :pep:`318`.
.. _async:
@@ -809,6 +815,8 @@
.. seealso::
:pep:`492` - Coroutines with async and await syntax
+ The proposal that made coroutines a proper standalone concept in Python,
+ and added supporting syntax.
.. rubric:: Footnotes
diff --git a/Doc/reference/simple_stmts.rst b/Doc/reference/simple_stmts.rst
index bb1eea6..f98721c 100644
--- a/Doc/reference/simple_stmts.rst
+++ b/Doc/reference/simple_stmts.rst
@@ -353,8 +353,15 @@
.. seealso::
- :pep:`526` - Variable and attribute annotation syntax
+ :pep:`526` - Syntax for Variable Annotations
+ The proposal that added syntax for annotating the types of variables
+ (including class variables and instance variables), instead of expressing
+ them through comments.
+
:pep:`484` - Type hints
+ The proposal that added the :mod:`typing` module to provide a standard
+ syntax for type annotations that can be used in static analysis tools and
+ IDEs.
.. _assert: