From de6c462335518e570b391f2b2a3f57de086c30ea Mon Sep 17 00:00:00 2001
From: Ofek Lev <ofekmeister@gmail.com>
Date: Sat, 7 Sep 2024 12:26:14 -0400
Subject: [PATCH] PEP 755: minor touchups (#3951)

---
 peps/pep-0755.rst | 32 +++++++++++++++++++++++++-------
 1 file changed, 25 insertions(+), 7 deletions(-)

diff --git a/peps/pep-0755.rst b/peps/pep-0755.rst
index e8f4ef147..ddbc7448b 100644
--- a/peps/pep-0755.rst
+++ b/peps/pep-0755.rst
@@ -106,6 +106,14 @@ common will be persisted internally for future reviewers to reference and new
 applications attempting to reserve a namespace that was previously rejected
 for that reason will display a warning.
 
+Acceptance
+''''''''''
+
+When an application is accepted for a namespace that is used by projects
+outside of the organization, an email will be sent to the owners of the
+projects notifying them of the new grant. The email will contain a link to the
+`namespace's page <namespace-page_>`_.
+
 Grant Types
 -----------
 
@@ -149,8 +157,18 @@ permitted organizations are transferred as well.
 User Interface
 --------------
 
-Prefix
-''''''
+.. _namespace-page:
+
+Namespace Page
+''''''''''''''
+
+The namespace of every active grant will have its own page that has information
+such as its :pep:`open <752#open-namespaces>` status, the current owners, the
+time at which ownership was granted and the total number of projects that match
+the namespace.
+
+Project Page
+''''''''''''
 
 Every project's page
 (`example <https://pypi.org/project/google-cloud-compute/1.19.2/>`__) that
@@ -159,9 +177,8 @@ currently does not do this) and will stand out as a pill or label. This value
 will match the ``prefix`` key in the
 :pep:`namespace detail API <752#namespace-detail>`.
 
-Clicking on the namespace will take the user to a page that has more
-information such as the current owners, the time at which ownership was granted
-and the total number of projects that match the namespace.
+Clicking on the namespace will take the user to
+`its page <namespace-page_>`_.
 
 Visual Indicators
 '''''''''''''''''
@@ -209,8 +226,9 @@ following circumstances:
 * The organization manually removes themselves as the owner.
 * The organization is deleted.
 
-When a reserved namespace becomes unclaimed, matching projects will no longer
-have a `visual indicator <user-interface_>`_.
+When a reserved namespace becomes unclaimed, the `UI <user-interface_>`_ will
+reflect this such that matching projects will no longer have any indicators on
+their page nor will the namespace have a dedicated page.
 
 How to Teach This
 =================