Skip to content

Commit 639c3d5

Browse files
committed
Add initial files to repo
1 parent d131700 commit 639c3d5

File tree

2 files changed

+84
-0
lines changed

2 files changed

+84
-0
lines changed

meta.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Attributes Meta Document
2+
3+
## 1. Summary
4+
5+
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.
6+
7+
## 2. Why Bother?
8+
9+
Right now libraries that want to use attributes either have to define them themselves or rely upon
10+
another library that has them defined. Most of the time that also means to import all the code of
11+
the other library.
12+
13+
Userland libraries have no interest in provising an interoperable set of attributes as they solve
14+
a specific problem with *their* set of attributes.
15+
16+
An interoperable shared registry with attribute definitions will solve this.
17+
18+
## 3. Scope
19+
20+
### 3.1 Goals
21+
22+
* 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.
23+
* Provide one or multiple composer-installable packages containing
24+
the code for the attributes in the registry
25+
* provide methods to maintain the registry and add, modify and remove attributes from it
26+
27+
### 3.2 Non-Goals
28+
29+
* The goal is **not** to provide a registry of **all** attributes available in PHP. As an example: The ORM-specific
30+
attributes from Doctrine are likely not to be part of this registry as they are specific to the library itself.
31+
32+
## 4. Approaches
33+
34+
TBD
35+
36+
37+
## 5. People
38+
39+
### 5.1 Editor
40+
41+
* Andreas Heigl
42+
43+
### 5.2 Sponsor
44+
45+
* Vincent de Lau
46+
47+
### 5.3 Working group members
48+
49+
* Juliette Reinders-Folmer
50+
* Jaap van Otterdijk
51+
* Larry Garfield
52+
53+
## 6. Votes
54+
55+
* [Entrance Vote](https://groups.google.com/g/php-fig/)
56+
* [Acceptance Vote](https://groups.google.com/g/php-fig/)
57+
58+
## 7. Relevant Links
59+
60+
61+
## 8. Past contributors
62+
63+
This document stems from the work of many people in previous years, we recognize their effort:
64+
65+
*
66+
_**Note:** Order descending chronologically._
67+
68+
## 9. FAQ
69+
70+
TBD

spec.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Attributes
2+
3+
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
4+
NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED",
5+
"MAY", and "OPTIONAL" in this document are to be interpreted as
6+
described in [BCP 14][] [[RFC 2119][]] [[RFC 8174][]] when, and only when, they
7+
appear in all capitals, as shown here.
8+
9+
[BCP 14]: https://datatracker.ietf.org/doc/html/bcp14/
10+
[RFC 2119]: https://datatracker.ietf.org/doc/html/rfc2119
11+
[RFC 8174]: https://datatracker.ietf.org/doc/html/rfc8174
12+
13+
## Overview
14+

0 commit comments

Comments
 (0)