Skip to content

Commit 07985ad

Browse files
committed
1.0.0
0 parents  commit 07985ad

29 files changed

+1109
-0
lines changed

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
node_modules
2+
*.*cache
3+
*.log*

.travis.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
language: node_js
2+
node_js:
3+
- stable

CHANGELOG.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Changes to CSS Database
2+
3+
### 1.0.0 (January 16, 2017)
4+
5+
- Initial version

LICENSE.md

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
# CC0 1.0 Universal
2+
3+
## Statement of Purpose
4+
5+
The laws of most jurisdictions throughout the world automatically confer
6+
exclusive Copyright and Related Rights (defined below) upon the creator and
7+
subsequent owner(s) (each and all, an “owner”) of an original work of
8+
authorship and/or a database (each, a “Work”).
9+
10+
Certain owners wish to permanently relinquish those rights to a Work for the
11+
purpose of contributing to a commons of creative, cultural and scientific works
12+
(“Commons”) that the public can reliably and without fear of later claims of
13+
infringement build upon, modify, incorporate in other works, reuse and
14+
redistribute as freely as possible in any form whatsoever and for any purposes,
15+
including without limitation commercial purposes. These owners may contribute
16+
to the Commons to promote the ideal of a free culture and the further
17+
production of creative, cultural and scientific works, or to gain reputation or
18+
greater distribution for their Work in part through the use and efforts of
19+
others.
20+
21+
For these and/or other purposes and motivations, and without any expectation of
22+
additional consideration or compensation, the person associating CC0 with a
23+
Work (the “Affirmer”), to the extent that he or she is an owner of Copyright
24+
and Related Rights in the Work, voluntarily elects to apply CC0 to the Work and
25+
publicly distribute the Work under its terms, with knowledge of his or her
26+
Copyright and Related Rights in the Work and the meaning and intended legal
27+
effect of CC0 on those rights.
28+
29+
1. Copyright and Related Rights. A Work made available under CC0 may be
30+
protected by copyright and related or neighboring rights (“Copyright and
31+
Related Rights”). Copyright and Related Rights include, but are not limited
32+
to, the following:
33+
1. the right to reproduce, adapt, distribute, perform, display,
34+
communicate, and translate a Work;
35+
2. moral rights retained by the original author(s) and/or performer(s);
36+
3. publicity and privacy rights pertaining to a person’s image or likeness
37+
depicted in a Work;
38+
4. rights protecting against unfair competition in regards to a Work,
39+
subject to the limitations in paragraph 4(i), below;
40+
5. rights protecting the extraction, dissemination, use and reuse of data
41+
in a Work;
42+
6. database rights (such as those arising under Directive 96/9/EC of the
43+
European Parliament and of the Council of 11 March 1996 on the legal
44+
protection of databases, and under any national implementation thereof,
45+
including any amended or successor version of such directive); and
46+
7. other similar, equivalent or corresponding rights throughout the world
47+
based on applicable law or treaty, and any national implementations
48+
thereof.
49+
50+
2. Waiver. To the greatest extent permitted by, but not in contravention of,
51+
applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
52+
unconditionally waives, abandons, and surrenders all of Affirmer’s Copyright
53+
and Related Rights and associated claims and causes of action, whether now
54+
known or unknown (including existing as well as future claims and causes of
55+
action), in the Work (i) in all territories worldwide, (ii) for the maximum
56+
duration provided by applicable law or treaty (including future time
57+
extensions), (iii) in any current or future medium and for any number of
58+
copies, and (iv) for any purpose whatsoever, including without limitation
59+
commercial, advertising or promotional purposes (the “Waiver”). Affirmer makes
60+
the Waiver for the benefit of each member of the public at large and to the
61+
detriment of Affirmer’s heirs and successors, fully intending that such Waiver
62+
shall not be subject to revocation, rescission, cancellation, termination, or
63+
any other legal or equitable action to disrupt the quiet enjoyment of the Work
64+
by the public as contemplated by Affirmer’s express Statement of Purpose.
65+
66+
3. Public License Fallback. Should any part of the Waiver for any reason be
67+
judged legally invalid or ineffective under applicable law, then the Waiver
68+
shall be preserved to the maximum extent permitted taking into account
69+
Affirmer’s express Statement of Purpose. In addition, to the extent the Waiver
70+
is so judged Affirmer hereby grants to each affected person a royalty-free, non
71+
transferable, non sublicensable, non exclusive, irrevocable and unconditional
72+
license to exercise Affirmer’s Copyright and Related Rights in the Work (i) in
73+
all territories worldwide, (ii) for the maximum duration provided by applicable
74+
law or treaty (including future time extensions), (iii) in any current or
75+
future medium and for any number of copies, and (iv) for any purpose
76+
whatsoever, including without limitation commercial, advertising or promotional
77+
purposes (the “License”). The License shall be deemed effective as of the date
78+
CC0 was applied by Affirmer to the Work. Should any part of the License for any
79+
reason be judged legally invalid or ineffective under applicable law, such
80+
partial invalidity or ineffectiveness shall not invalidate the remainder of the
81+
License, and in such case Affirmer hereby affirms that he or she will not (i)
82+
exercise any of his or her remaining Copyright and Related Rights in the Work
83+
or (ii) assert any associated claims and causes of action with respect to the
84+
Work, in either case contrary to Affirmer’s express Statement of Purpose.
85+
86+
4. Limitations and Disclaimers.
87+
1. No trademark or patent rights held by Affirmer are waived, abandoned,
88+
surrendered, licensed or otherwise affected by this document.
89+
2. Affirmer offers the Work as-is and makes no representations or
90+
warranties of any kind concerning the Work, express, implied, statutory
91+
or otherwise, including without limitation warranties of title,
92+
merchantability, fitness for a particular purpose, non infringement, or
93+
the absence of latent or other defects, accuracy, or the present or
94+
absence of errors, whether or not discoverable, all to the greatest
95+
extent permissible under applicable law.
96+
3. Affirmer disclaims responsibility for clearing rights of other persons
97+
that may apply to the Work or any use thereof, including without
98+
limitation any person’s Copyright and Related Rights in the Work.
99+
Further, Affirmer disclaims responsibility for obtaining any necessary
100+
consents, permissions or other rights required for any use of the Work.
101+
4. Affirmer understands and acknowledges that Creative Commons is not a
102+
party to this document and has no duty or obligation with respect to
103+
this CC0 or use of the Work.
104+
105+
For more information, please see
106+
http://creativecommons.org/publicdomain/zero/1.0/.

README.md

Lines changed: 162 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,162 @@
1+
# CSS Database [<img src="https://rawgit.com/jonathantneal/media-expressions-spec/gh-pages/css-logo.svg" alt="CSS Logo" width="90" height="90" align="right">][CSS Database]
2+
3+
[![Build Status][cli-img]][cli-url]
4+
[![Licensing][lic-img]][lic-url]
5+
[![Changelog][log-img]][log-url]
6+
7+
[CSS Database] is a comprehensive list of CSS features and their positions in the process of becoming implemented web standards. These positions reflect the [TC39 process].
8+
9+
## Staging Process
10+
11+
This staging process reflects the real-life stability of new CSS features.
12+
13+
You can read an [inside view of the CSSWG] to learn about the official (and unofficial) development stages of CSS specifications. In reality, specifications and browser implementations happen out of sync. Stable CSS features are missing in all browsers, while other CSS features developed outside the [CSSWG] are already behind flags in Chrome. This is too ambiguous for the web development community, and a more accountable process is desired.
14+
15+
#### Stage 0: Aspirational
16+
17+
> “This is a crazy idea.”
18+
19+
A CSS specification presented to the CSSWG by a [champion] within or outside the CSSWG. It should be considered highly instable and subject to change.
20+
21+
#### Stage 1: Experimental
22+
23+
> “This idea might not be crazy.”
24+
25+
A CSS specification formally endorsed by the [CSSWG]. It should be considered highly instable and subject to change.
26+
27+
#### Stage 2: Draft
28+
29+
> “This idea is not crazy.”
30+
31+
A CSS specification formally endorsed by the [CSSWG] and requiring implementations to move forward. It should be considered stable and subject to little change.
32+
33+
#### Stage 3: Adoption
34+
35+
> “This idea is becoming part of the web.”
36+
37+
A CSS specification formally endorsed by the [CSSWG] and being implemented by [recognized browser vendors], possibly behind a flag. It should be considered stable and subject to little change.
38+
39+
#### Stage 4: Complete
40+
41+
> “This idea is part of the web.”
42+
43+
A CSS specification formally endorsed by the [CSSWG] and implemented by all [recognized browser vendors].
44+
45+
#### No Stage: Unrecognized
46+
47+
> “I have no idea what I’m doing.”
48+
49+
This is any specification that has not yet been presented to the [CSSWG], or that has been formally rejected or deprecated by the [CSSWG].
50+
51+
## Contributing
52+
53+
### Join the CSSWG
54+
55+
Passionate and informed developers should consider joining the CSSWG. Read the [instructions for joining the CSSWG]. Pull requests are welcomed to update this section with a beginner-friendly version of those instructions.
56+
57+
### Update this database
58+
59+
Pull requests are some of the greatest contributions, so be sure they are focused in scope and avoid unrelated commits.
60+
61+
- All contributions must follow the syntax and style of existing JSON files, which;
62+
1. Exist as `features/${ feature }.json`, where `feature` is a thematic, [kebab-case] label representing the title and category of the feature.
63+
2. Include all the [required fields].
64+
65+
- New features include a link to a specification, which;
66+
1. Describes what the feature does in as few words as possible.
67+
2. Describes why the feature exists in as few words as possible.
68+
3. Describes how the feature and its parts operate as clearly and completely as possible.
69+
70+
- Changing features include a relevant citation proving its new position in the [staging process].
71+
72+
For best results, be sure your contributions make sense to everyone else. If you’re unfamiliar with git, consider the following workflow.
73+
74+
1. To begin, [fork this project], clone your fork, and add our upstream.
75+
```bash
76+
# Clone your fork of the repo into the current directory
77+
git clone https://github.com/<your-user>/${ id }
78+
# Navigate to the newly cloned directory
79+
cd ${ id }
80+
# Assign the original repo to a remote called "upstream"
81+
git remote add upstream https://github.com/${ user }/${ id }
82+
# Install the tools necessary for development
83+
npm install
84+
```
85+
86+
2. Create a branch for your feature or update:
87+
```bash
88+
# Move into a new branch for a feature
89+
git checkout -b feature/thing
90+
```
91+
```bash
92+
# Or, move into a new branch for a update
93+
git checkout -b update/something
94+
```
95+
96+
3. Be sure your code follows our practices.
97+
```bash
98+
# Test current code
99+
npm test
100+
```
101+
102+
4. Push your branch up to your fork:
103+
```bash
104+
# Push a feature branch
105+
git push origin feature/thing
106+
```
107+
```bash
108+
# Or, push a fix branch
109+
git push origin fix/something
110+
```
111+
112+
---
113+
114+
## Terminology
115+
116+
### Required Fields
117+
118+
Required fields within a JSON file are, in order:
119+
120+
- **`title`**: a unique name for the feature.
121+
- **`description`**: a brief description of the feature.
122+
- **`specification`**: a link to the latest draft of the specification.
123+
- **`stage`**: the position of the feature within the [staging process]. Stages should be a number, and unrecognized stages should be `null`.
124+
- **`citations`**: an array of links related to the feature or its progress.
125+
126+
### Additional Fields
127+
128+
Additional fields within a JSON file may be, in order:
129+
130+
- **`issues`**: a link to issue tracking for the feature.
131+
- **`polyfills`**: an array of links to polyfills for the feature. Each link contains a `name` and `link` field, in that order.
132+
133+
### Recognized Browser Vendors
134+
135+
Recognized browser vendors include, in alphabetical order; Apple, Google, Microsoft, Mozilla, and Opera.
136+
137+
### Champion
138+
139+
A champion is the person responsible for advocating a new CSS feature to completion, performing the legwork necessary to ensure the concerns of interested [CSSWG] members are identified and incorporated into the proposal.
140+
141+
[Champion]: #champion
142+
[CSSWG]: https://wiki.csswg.org/spec
143+
[CSS Database]: https://github.com/jonathantneal/css-db
144+
[fork this project]: fork
145+
[inside view of the CSSWG]: http://fantasai.inkedblade.net/weblog/2011/inside-csswg/process
146+
[instructions for joining the CSSWG]: https://www.w3.org/2004/01/pp-impl/32061/instructions
147+
[kebab-case]: http://wiki.c2.com/?KebabCase
148+
[recognized browser vendors]: #recognized-browser-vendors
149+
[required fields]: #required-fields
150+
[staging process]: #staging-process
151+
[TC39 process]: https://thefeedbackloop.xyz/tc39-a-process-sketch-stages-0-and-1/
152+
153+
[npm-url]: https://www.npmjs.com/package/css-db
154+
[npm-img]: https://img.shields.io/npm/v/css-db.svg
155+
[cli-url]: https://travis-ci.org/jonathantneal/css-db
156+
[cli-img]: https://img.shields.io/travis/jonathantneal/css-db.svg
157+
[lic-url]: LICENSE.md
158+
[lic-img]: https://img.shields.io/badge/license-CC0--1.0-blue.svg
159+
[log-url]: CHANGELOG.md
160+
[log-img]: https://img.shields.io/badge/changelog-md-blue.svg
161+
[git-url]: https://gitter.im/postcss/postcss
162+
[git-img]: https://img.shields.io/badge/chat-gitter-blue.svg

0 commit comments

Comments
 (0)