Address @pradyunsg's review

pypa · Dec 22, 2023 · 2341590 · 2341590
1 parent 3a90a88
commit 2341590
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 10 deletions.
diff --git a/source/specifications/core-metadata.rst b/source/specifications/core-metadata.rst
@@ -76,7 +76,8 @@ Name
    Added restrictions on format from the :ref:`name grammar <name-grammar>`.
 
 The name of the distribution. The name field is the primary identifier for a
-distribution. It must conform to the :ref:`package name grammar <name-grammar>`.
+distribution. It must conform to the :ref:`name format specification
+<name-format>`.
 
 Example::
 

diff --git a/source/specifications/name-normalization.rst b/source/specifications/name-normalization.rst
@@ -1,16 +1,16 @@
-======================================
-Package name grammar and normalization
-======================================
+=======================
+Names and normalization
+=======================
 
-Project names obey a restricted format, and are "normalized" for use in various
-contexts. This document describes what the valid project names are, and how
-project names should be normalized.
+This specification defines the format that names for packages and extras are
+required to follow. It also describes how to normalize them, which should be
+done before lookups and comparisons.
 
 
-.. _name-grammar:
+.. _name-format:
 
-Name grammar
-============
+Name format
+===========
 
 A valid name consists only of ASCII letters and numbers, period,
 underscore and hyphen. It must start and end with a letter or number.