From 579e04093b18c4f115925fbf69b97494bfc30457 Mon Sep 17 00:00:00 2001 From: Andreas Heigl Date: Mon, 16 Jun 2025 22:08:13 +0200 Subject: [PATCH 1/5] Add attributes-meta document This is a first draft to get the whole PER process started --- proposed/attributes-meta.md | 77 +++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 proposed/attributes-meta.md diff --git a/proposed/attributes-meta.md b/proposed/attributes-meta.md new file mode 100644 index 000000000..5e6950363 --- /dev/null +++ b/proposed/attributes-meta.md @@ -0,0 +1,77 @@ +# Attributes Meta Document + +## 1. Summary + +The idea is to create a registry that holds and provides user-space attributes for PHP. + +This Proposal is about defining the registry and the workflows to add, modify and +remove attributes from that registry + +## 2. Why Bother? + +Right now libraries that want to use attributes either have to define them themselves or rely upon +another library that has them defined. Most of the time that also means to import all the code of +the other library. + +Userland libraries have no interest in provising an interoperable set of attributes as they solve +a specific problem with *their* set of attributes. + +This registry shall solve that + +## 3. Scope + +### 3.1 Goals + +* Define and maintain a set of attributes that are relevant for more than one + single tool so that different tools can use and rely upon a defined set of attributes and + users do not need to use several similar attributes with the same meaning for different tools. +* Provide one or multiple composer-installable packages containing + the code for the attributes in the registry +* provide methods to maintain the registry and add, modify and remove attributes from it + +### 3.2 Non-Goals + +* The goal is **not** to provide a registry of **all** attributes available in PHP. As an example: The ORM-specific + attributes from Doctrine are likely not to be part of this registry as they are specific to the library itself + +## 4. Approaches + +TBD + + +## 5. People + +### 5.1 Editor + + * TBD + +### 5.2 Sponsor + + * TBD + +### 5.3 Working group members + + * Juliette Reinders-Folmer + * Jaap vsn Otterdijk + * Vincent de Lau + * Larry Garfield + * Andreas Heigl + +## 6. Votes + +* [Entrance Vote](https://groups.google.com/g/php-fig/) +* [Acceptance Vote](https://groups.google.com/g/php-fig/) + +## 7. Relevant Links + + +## 8. Past contributors + +This document stems from the work of many people in previous years, we recognize their effort: + + * +_**Note:** Order descending chronologically._ + +## 9. FAQ + +TBD \ No newline at end of file From 477daa178dd1c4585dd2d0e5d2a7922e24f76080 Mon Sep 17 00:00:00 2001 From: Andreas Heigl Date: Tue, 17 Jun 2025 06:24:28 +0200 Subject: [PATCH 2/5] Apply suggestions from code review Co-authored-by: Larry Garfield --- proposed/attributes-meta.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/proposed/attributes-meta.md b/proposed/attributes-meta.md index 5e6950363..bf1794caf 100644 --- a/proposed/attributes-meta.md +++ b/proposed/attributes-meta.md @@ -2,10 +2,7 @@ ## 1. Summary -The idea is to create a registry that holds and provides user-space attributes for PHP. - -This Proposal is about defining the registry and the workflows to add, modify and -remove attributes from that registry +This Working Group aims to create and manage a shared set of PHP attributes that may be used by many different actors within the PHP ecosystem, avoiding duplication and redundancy. ## 2. Why Bother? @@ -22,9 +19,7 @@ This registry shall solve that ### 3.1 Goals -* Define and maintain a set of attributes that are relevant for more than one - single tool so that different tools can use and rely upon a defined set of attributes and - users do not need to use several similar attributes with the same meaning for different tools. +* Define and maintain a set of attribute definitions that are relevant for a reasonably broad portion of the PHP ecosystem so that different tools and users can use and rely upon a defined set of attributes with less duplication. * Provide one or multiple composer-installable packages containing the code for the attributes in the registry * provide methods to maintain the registry and add, modify and remove attributes from it @@ -32,7 +27,7 @@ This registry shall solve that ### 3.2 Non-Goals * The goal is **not** to provide a registry of **all** attributes available in PHP. As an example: The ORM-specific - attributes from Doctrine are likely not to be part of this registry as they are specific to the library itself + attributes from Doctrine are likely not to be part of this registry as they are specific to the library itself. ## 4. Approaches From 6c9b589d8bead9a84523b61d241698a7ceee565d Mon Sep 17 00:00:00 2001 From: Andreas Heigl Date: Tue, 17 Jun 2025 06:25:53 +0200 Subject: [PATCH 3/5] Set editor and sponsor --- proposed/attributes-meta.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/proposed/attributes-meta.md b/proposed/attributes-meta.md index bf1794caf..6495a1114 100644 --- a/proposed/attributes-meta.md +++ b/proposed/attributes-meta.md @@ -38,19 +38,17 @@ TBD ### 5.1 Editor - * TBD + * Andreas Heigl ### 5.2 Sponsor - * TBD + * Vincent de Lau ### 5.3 Working group members * Juliette Reinders-Folmer * Jaap vsn Otterdijk - * Vincent de Lau * Larry Garfield - * Andreas Heigl ## 6. Votes From fd4e2398cebeeff70b44dfb3407b8f601ecf7b21 Mon Sep 17 00:00:00 2001 From: Andreas Heigl Date: Tue, 17 Jun 2025 07:47:09 +0200 Subject: [PATCH 4/5] Update proposed/attributes-meta.md Co-authored-by: Korvin Szanto --- proposed/attributes-meta.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/proposed/attributes-meta.md b/proposed/attributes-meta.md index 6495a1114..de5074a01 100644 --- a/proposed/attributes-meta.md +++ b/proposed/attributes-meta.md @@ -47,7 +47,7 @@ TBD ### 5.3 Working group members * Juliette Reinders-Folmer - * Jaap vsn Otterdijk + * Jaap van Otterdijk * Larry Garfield ## 6. Votes From 0d2e30a8ba937620655bd7f86edf37ca8c1dd482 Mon Sep 17 00:00:00 2001 From: Andreas Heigl Date: Tue, 17 Jun 2025 08:00:54 +0200 Subject: [PATCH 5/5] Thanks @jaapio --- proposed/attributes-meta.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/proposed/attributes-meta.md b/proposed/attributes-meta.md index de5074a01..115c29331 100644 --- a/proposed/attributes-meta.md +++ b/proposed/attributes-meta.md @@ -13,7 +13,7 @@ the other library. Userland libraries have no interest in provising an interoperable set of attributes as they solve a specific problem with *their* set of attributes. -This registry shall solve that +An interoperable shared registry with attribute definitions will solve this. ## 3. Scope