Should "within a "base directory"" be changed to "of the "base directory""
Hi All, First up, apologies if this issue has already been raised. Upon reading PSR-4: Autoloader, I found a statement that I think may benefit with a small change to clarify it's intent. In Section 2.Specification, Subsection 3. When loading a file that corresponds to a fully qualified class name ... Clause 2 states "The contiguous sub-namespace names after the "namespace prefix" correspond to a subdirectory *within a* "base directory"" The problem I have experienced is with the use of "*within a"*. Using the second example in section 3. Examples FULLY QUALIFIED CLASS NAME: \Aura\Web\Response\Status NAMESPACE PREFIX: Aura\Web BASE DIRECTORY: /path/to/aura-web/src/ RESULTING FILE PATH: /path/to/aura-web/src/Response/Status.php I would interpret "a subdirectory *within a* "base directory"" here to refer to either "/path/", "/to/", "/aura-web/" or "/src/" and not the subdirectory "/Response/", which appears to be the intention. Personally I think clause 2 would become more clear if *within a* where changed to *of the* as follows "The contiguous sub-namespace names after the "namespace prefix" correspond to a subdirectory *of the* "base directory"" Whilst I think I have eventually been able to work out the meaning from the examples, the current phrasing of clause 2 confused me originally requiring a few re-reads. What does everyone think? Has anyone else found the current phrasing confusing or is it adequate? Would my suggestion make things better or worse? Is there another phrasing that could be considered? Best Regards, Steve Ward -- You received this message because you are subscribed to the Google Groups "PHP Framework Interoperability Group" group. To unsubscribe from this group and stop receiving emails from it, send an email to php-fig+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/php-fig/61264175-f435-4c57-bd0d-088e3388c3a7n%40googlegroups.com.
