From 137938567f6b6ce8ec590b415a10ae9f0eb0a309 Mon Sep 17 00:00:00 2001
From: Stefano Zacchiroli <zack@upsilon.cc>
Date: Mon, 27 Apr 2020 15:17:50 +0200
Subject: [PATCH] SWHID spec: simplify and generalize escaping requirements

---
 docs/persistent-identifiers.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/docs/persistent-identifiers.rst b/docs/persistent-identifiers.rst
index dd5a5dbe..2d40c3e0 100644
--- a/docs/persistent-identifiers.rst
+++ b/docs/persistent-identifiers.rst
@@ -174,11 +174,13 @@ the ``<identifier_with_context>`` entry point of the grammar:
 
 Where:
 
-- ``<path_absolute_escaped>`` is an ``<ipath-absolute>`` from `RFC 3987`_,
-  where all occurrences of ``;`` and ``%`` have been percent-encoded (as
-  ``%3B`` and ``%25`` respectively)
-- ``<url_escaped>`` is a `RFC 3987`_ IRI, where all occurrences of ``;`` and
-  ``%`` have been percent-encoded, as per ``<path_absolute_escaped>`` above
+- ``<path_absolute_escaped>`` is an ``<ipath-absolute>`` from `RFC 3987`_, and
+- ``<url_escaped>`` is a `RFC 3987`_ IRI
+
+in either case all occurrences of ``;`` (and ``%``, as required by the RFC)
+have been percent-encoded (as ``%3B`` and ``%25`` respectively). Other
+characters *can* be percent-encoded, e.g., to improve readability and/or
+embeddability of SWHID in other contexts.
 
 .. _RFC 3987: https://tools.ietf.org/html/rfc3987
 
-- 
GitLab