Skip to content

Commit 38706ea

Browse files
committed
drop documentation for branching conventions
1 parent 36022d6 commit 38706ea

File tree

6 files changed

+12
-42
lines changed

6 files changed

+12
-42
lines changed

generator/content/how-to/create.html

+2-5
Original file line numberDiff line numberDiff line change
@@ -44,11 +44,8 @@ <h2 id="forking">Forking</h2>
4444
for you.
4545
</p>
4646
<p>
47-
Check it out and create a new topic branch. The rule for branches is very simple:
48-
<code>master</code> is for things that have shipped in implementations and are well-tested, and
49-
<code>develop</code> is for stuff that doesn't yet pass tests but that does have clear
50-
implementation commitments from browser vendors. If not in either of the previous two
51-
categories, just pick a self-descriptive name that you like.
47+
Check it out and create a new topic branch. There are no specific rules for branches, but if
48+
making a proposal for a specific feature do try to pick a descriptive name.
5249
</p>
5350
<p>
5451
You will then need to edit your specification. WebSpecs can come in two formats. If you see a

generator/content/index.html

-8
Original file line numberDiff line numberDiff line change
@@ -191,14 +191,6 @@ <h2>How Things Work</h2>
191191
world, simply make a pull request to have it linked to from
192192
<a href="https://github.com/webspecs/the-index">the index</a>.
193193
</p>
194-
<p>
195-
One thing that is important to note: we ascribe specific meaning to some <code>git</code>
196-
branches. We reserve <code>master</code> for specifications that are well supported in
197-
implementations (as demonstrated using a credible test suite) and <code>develop</code>
198-
for specifications that are in the process of being implemented by vendors (i.e. they have
199-
shown genuine interest and some buggy, partial code is being worked on). For specifications
200-
that are still just proposals, please use any other branch name.
201-
</p>
202194
<p>
203195
That’s it! Or at least, that’s all you need to understand to get started. We are building
204196
extensive documentation. And like everything we do, if you don’t like it,

generator/content/policy/principles.html

+4-8
Original file line numberDiff line numberDiff line change
@@ -47,14 +47,10 @@
4747
</dd>
4848
<dt id="tested">Tested</dt>
4949
<dd>
50-
There is only one difference between a WebSpecs specification sitting in a topic branch and
51-
one that’s taken into the <code>master</code> branch: testing. If a specification
52-
has a good enough (for sane values of “good enough”, perfection not being of this world)
53-
test suite in our sister <a href="https://github.com/w3c/web-platform-tests/">Web Platform
54-
Tests</a> project and that test suite has a <em>good enough</em> pass ratio in at least a
55-
couple of major browsers, then that specification is good to merge to <code>master</code>.
56-
If it is being implemented but isn’t yet tested well enough, it’s in <code>develop</code>.
57-
Otherwise, it’s a proposal.
50+
Web Platform Specs and <a href="https://github.com/w3c/web-platform-tests/">Web Platform
51+
Tests</a> are obvious sibling projects. The same spirit that prevails here applies there, and
52+
all WebSpec projects are strongly encouraged to contribute testing relevant to their
53+
specification to WPT.
5854
</dd>
5955
</dl>
6056
<p>

how-to/create.html

+2-5
Original file line numberDiff line numberDiff line change
@@ -69,11 +69,8 @@ <h2 id="forking">Forking</h2>
6969
for you.
7070
</p>
7171
<p>
72-
Check it out and create a new topic branch. The rule for branches is very simple:
73-
<code>master</code> is for things that have shipped in implementations and are well-tested, and
74-
<code>develop</code> is for stuff that doesn't yet pass tests but that does have clear
75-
implementation commitments from browser vendors. If not in either of the previous two
76-
categories, just pick a self-descriptive name that you like.
72+
Check it out and create a new topic branch. There are no specific rules for branches, but if
73+
making a proposal for a specific feature do try to pick a descriptive name.
7774
</p>
7875
<p>
7976
You will then need to edit your specification. WebSpecs can come in two formats. If you see a

index.html

-8
Original file line numberDiff line numberDiff line change
@@ -206,14 +206,6 @@ <h2>How Things Work</h2>
206206
world, simply make a pull request to have it linked to from
207207
<a href="https://github.com/webspecs/the-index">the index</a>.
208208
</p>
209-
<p>
210-
One thing that is important to note: we ascribe specific meaning to some <code>git</code>
211-
branches. We reserve <code>master</code> for specifications that are well supported in
212-
implementations (as demonstrated using a credible test suite) and <code>develop</code>
213-
for specifications that are in the process of being implemented by vendors (i.e. they have
214-
shown genuine interest and some buggy, partial code is being worked on). For specifications
215-
that are still just proposals, please use any other branch name.
216-
</p>
217209
<p>
218210
That’s it! Or at least, that’s all you need to understand to get started. We are building
219211
extensive documentation. And like everything we do, if you don’t like it,

policy/principles.html

+4-8
Original file line numberDiff line numberDiff line change
@@ -72,14 +72,10 @@ <h1 class="onlyTitle">Core Principles</h1>
7272
</dd>
7373
<dt id="tested">Tested</dt>
7474
<dd>
75-
There is only one difference between a WebSpecs specification sitting in a topic branch and
76-
one that’s taken into the <code>master</code> branch: testing. If a specification
77-
has a good enough (for sane values of “good enough”, perfection not being of this world)
78-
test suite in our sister <a href="https://github.com/w3c/web-platform-tests/">Web Platform
79-
Tests</a> project and that test suite has a <em>good enough</em> pass ratio in at least a
80-
couple of major browsers, then that specification is good to merge to <code>master</code>.
81-
If it is being implemented but isn’t yet tested well enough, it’s in <code>develop</code>.
82-
Otherwise, it’s a proposal.
75+
Web Platform Specs and <a href="https://github.com/w3c/web-platform-tests/">Web Platform
76+
Tests</a> are obvious sibling projects. The same spirit that prevails here applies there, and
77+
all WebSpec projects are strongly encouraged to contribute testing relevant to their
78+
specification to WPT.
8379
</dd>
8480
</dl>
8581
<p>

0 commit comments

Comments
 (0)