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.
