diff --git a/api/src/main/java/jakarta/faces/application/ResourceHandler.java b/api/src/main/java/jakarta/faces/application/ResourceHandler.java
index bd8e86d264..503d0237d8 100644
--- a/api/src/main/java/jakarta/faces/application/ResourceHandler.java
+++ b/api/src/main/java/jakarta/faces/application/ResourceHandler.java
@@ -270,7 +270,7 @@ public abstract class ResourceHandler {
      * The algorithm specified in section 2.6.1.4 "Libraries of Localized and Versioned Resources" of the Jakarta Faces Specification Document
      * must be executed to create
      * the <code>Resource</code>. <span class="changed_added_2_2">New requirements were introduced in version 2.2 of the
-     * specification. For historical reasons, this method operate correctly when the argument {@code resourceName} is of the
+     * specification. For historical reasons, this method <span class="changed_added_5_0">must</span> operate correctly when the argument {@code resourceName} is of the
      * form {@code libraryName/resourceName}, even when {@code resourceName} contains '/' characters. </span>
      * </p>
      *
@@ -307,7 +307,7 @@ public abstract class ResourceHandler {
      *
      * <li>
      * <p>
-     * Considering resource library contracts (at the locations specified in the 
+     * Considering resource library contracts (at the locations specified in the
      * Jakarta Faces Specification Document section 2.7 "Resource Library Contracts").
      * </p>
      * </li>
@@ -320,7 +320,7 @@ public abstract class ResourceHandler {
      *
      * <li>
      * <p>
-     * Considering faces flows (at the locations specified in the 
+     * Considering faces flows (at the locations specified in the
      * Jakarta Faces Specification Document section 11.3.3 "Faces Flows").
      * </p>
      * </li>
@@ -417,7 +417,7 @@ public Stream<String> getViewResources(FacesContext facesContext, String path, R
      * <div class="changed_added_2_2">
      *
      * <p>
-     * The resource must be identified according to the specification in 
+     * The resource must be identified according to the specification in
      * section 2.6.1.3 "Resource Identifiers" of the Jakarta Faces Specification Document. New requirements were
      * introduced in version 2.2 of the specification.
      * </p>
diff --git a/spec/src/main/asciidoc/RequestProcessingLifecycle.adoc b/spec/src/main/asciidoc/RequestProcessingLifecycle.adoc
index da1a229384..d35a77e64d 100644
--- a/spec/src/main/asciidoc/RequestProcessingLifecycle.adoc
+++ b/spec/src/main/asciidoc/RequestProcessingLifecycle.adoc
@@ -1742,7 +1742,8 @@ be ignored silently.
 in the __localePrefix__, __libraryName__, __libraryVerison__,
 _resourceName_ and _resourceVersion_ segments of the resource identifier
 is specififed as XML NameChar excluding the path separator and ‘:’
-characters. The specification for XML NameChar may be seen at
+characters, with the exception of resourceName, which may contain the path separator
+character. The specification for XML NameChar may be seen at
 __https://www.w3.org/TR/REC-xml/#NT-NameChar__.
 
 * A further restriction applies to