diff --git a/meta.md b/meta.md index 0eabf9b..df2f527 100644 --- a/meta.md +++ b/meta.md @@ -44,18 +44,26 @@ This PER shares the same goals as PSR-12. > of guidelines to be used among all those projects. Thus, the benefit of this guide is > not in the rules themselves, but in the sharing of those rules. -This PER is an extension of PSR-12, and therefore also an extension of PSR-1. +This PER extends, expands and replaces PSR-12, and is therefore also an extension of PSR-1. With PSR-12 being the base of this PER, a list of differences is provided below to assist with migration, but it should be considered as an independent specification. +This PER will eventually incorporate and replace any stylistic requirements found in PSR-1. +PSR-1 includes a number of non-stylistic requirements that affect runtime behavior, which are +out of scope for this PER. If a particular rule is mentioned in both this PER and PSR-1, +this PER takes precedence. If not, the PSR-1 rule (including errata) still applies. + This PER will include coding style guidelines related to new functionality added to PHP -after the publication of PSR-12. This PER will also include clarifications on the text of -PSR-12. +after the publication of PSR-12, as well as clarifications on the text of PSR-12. +It is a goal of this PER to maintain style consistency between related old and new PHP syntax, +such as class constants and constants in enumerations. In rare cases, this may cause new +releases to include coding style guidelines that break backwards compatibility, limited by +the non-goals and versioning sections below. ### 3.2. Non-Goals -It is not the intention of this PER to add entirely new coding style guidelines. It will -also not change anything stipulated in PSR-1 and PSR-12. +It is not the intention of this PER to substantially or arbitrarily alter coding style guidelines found in PSR-1 and PSR-12. +It will not change anything stipulated in PSR-1 that concerns technical interoperability or runtime behaviour. ## 4. Approaches