|
| 1 | +# Attributes Meta Document |
| 2 | + |
| 3 | +## 1. Summary |
| 4 | + |
| 5 | +The idea is to create a registry that holds and provides user-space attributes for PHP. |
| 6 | + |
| 7 | +This Proposal is about defining the registry and the workflows to add, modify and |
| 8 | +remove attributes from that registry |
| 9 | + |
| 10 | +## 2. Why Bother? |
| 11 | + |
| 12 | +Right now libraries that want to use attributes either have to define them themselves or rely upon |
| 13 | +another library that has them defined. Most of the time that also means to import all the code of |
| 14 | +the other library. |
| 15 | + |
| 16 | +Userland libraries have no interest in provising an interoperable set of attributes as they solve |
| 17 | +a specific problem with *their* set of attributes. |
| 18 | + |
| 19 | +This registry shall solve that |
| 20 | + |
| 21 | +## 3. Scope |
| 22 | + |
| 23 | +### 3.1 Goals |
| 24 | + |
| 25 | +* Define and maintain a set of attributes that are relevant for more than one |
| 26 | + single tool so that different tools can use and rely upon a defined set of attributes and |
| 27 | + users do not need to use several similar attributes with the same meaning for different tools. |
| 28 | +* Provide one or multiple composer-installable packages containing |
| 29 | + the code for the attributes in the registry |
| 30 | +* provide methods to maintain the registry and add, modify and remove attributes from it |
| 31 | + |
| 32 | +### 3.2 Non-Goals |
| 33 | + |
| 34 | +* The goal is **not** to provide a registry of **all** attributes available in PHP. As an example: The ORM-specific |
| 35 | + attributes from Doctrine are likely not to be part of this registry as they are specific to the library itself |
| 36 | + |
| 37 | +## 4. Approaches |
| 38 | + |
| 39 | +TBD |
| 40 | + |
| 41 | + |
| 42 | +## 5. People |
| 43 | + |
| 44 | +### 5.1 Editor |
| 45 | + |
| 46 | + * TBD |
| 47 | + |
| 48 | +### 5.2 Sponsor |
| 49 | + |
| 50 | + * TBD |
| 51 | + |
| 52 | +### 5.3 Working group members |
| 53 | + |
| 54 | + * Juliette Reinders-Folmer |
| 55 | + * Jaap vsn Otterdijk |
| 56 | + * Vincent de Lau |
| 57 | + * Larry Garfield |
| 58 | + * Andreas Heigl |
| 59 | + |
| 60 | +## 6. Votes |
| 61 | + |
| 62 | +* [Entrance Vote](https://groups.google.com/g/php-fig/) |
| 63 | +* [Acceptance Vote](https://groups.google.com/g/php-fig/) |
| 64 | + |
| 65 | +## 7. Relevant Links |
| 66 | + |
| 67 | + |
| 68 | +## 8. Past contributors |
| 69 | + |
| 70 | +This document stems from the work of many people in previous years, we recognize their effort: |
| 71 | + |
| 72 | + * |
| 73 | +_**Note:** Order descending chronologically._ |
| 74 | + |
| 75 | +## 9. FAQ |
| 76 | + |
| 77 | +TBD |
0 commit comments