Skip to content

Commit 579e040

Browse files
committed
Add attributes-meta document
This is a first draft to get the whole PER process started
1 parent 25c9c4c commit 579e040

File tree

1 file changed

+77
-0
lines changed

1 file changed

+77
-0
lines changed

proposed/attributes-meta.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
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

Comments
 (0)