I would like to extend the documentation in 
https://sling.apache.org/documentation/the-sling-engine/url-decomposition.html 
a bit.

Basically for the Resource Path section it says:

Resource Path - The longest substring of the request URL such that the resource 
path is either the complete request URL or the next character in the request 
URL after the resource path is a dot (.).

I would like to modify that to:

Resource Path - The longest substring of the request URL pointing to an 
existing resource (taking into account any resource mapping rules) such that 
this part is either the full request URL or the next character in the request 
URL after the resource path is a dot (.). 
Without knowing the repository structure it is impossible to say which part of 
the request URL is the resource path, because the resource path does not 
necessarily end with the first dot (.) in the request url, as resource names 
itself and therefore the resource path as well may contain dots (.). Therefore 
it is impossible to tell just by looking at the request URL string how it is 
gonna be decomposed by Sling.

This is IMHO an important aspect and should be explicitly mentioned on the page 
https://sling.apache.org/documentation/the-sling-engine/url-decomposition.html

Is everyone fine with that change?
Konrad

P.S. This change is triggered by the PR 
https://github.com/apache/sling/pull/172 which incorrectly assumes that the 
first dot separates the resource path from the rest.

Reply via email to