-
Notifications
You must be signed in to change notification settings - Fork 2
/
index.bs
80 lines (68 loc) · 3.7 KB
/
index.bs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<h1>WebSpec Example</h1>
<pre class='metadata'>
Shortname: example-spec
Group: WebSpecs
Abstract: This specification is meant to evolve into a permanent example of how a WebSpec is made. Before that, though, it is used primarily as a an area in which to develop this specification style.
</pre>
<h2 id='intro'>
Introduction</h2>
A lot can get in the way of writing a good specification. The formalism, while necessary, can
inhibit creativity and eat up precious time.
WebSpecs use a specific variant of Markdown called "Bikeshed" (after the famous
<a href="https://en.wikipedia.org/wiki/Parkinson%27s_law_of_triviality">Parkinson law of triviality</a>
which is commonly known as "bikeshedding" in the standards world). It does a lot of things for
you, allowing you to focus on the content. Adopting a common source format for all WebSpecs also
means that anyone who has contributed to one spec will immediately know how to help with another
— a situation rather different from the many fragmented tools currently in use for standards.
<h3 id='example'>
Exemplify</h3>
<div class='example'>
Examples can be included at any time, and here we have a great specimen, even given its own
subsection.
<pre>#webspecs { will-change: all; }</pre>
</div>
<h2 id='eldef'>
Element Definitions</h2>
We currently have the following used to define CSS properties. We want the same for elements and
any number of other common aspects.
<pre class='propdef'>
Name: will-change
Value: auto | <<animateable-feature>>#
Initial: auto
Applies to: all elements
Inherited: no
Percentages: n/a
Media: all
Computed value: specified value
</pre>
<p>
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt
ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in
voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
</p>
<div class='note'>
This includes generating the right <code>dfn</code> elements, table of elements, etc.
</div>
<p>
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt
ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in
voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
</p>
<div class='issue'>
This is a really serious problem that demands our immediate attention.
This is a really serious problem that demands our immediate attention.
This is a really serious problem that demands our immediate attention.
This is a really serious problem that demands our immediate attention.
This is a really serious problem that demands our immediate attention.
</div>
<p>
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt
ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in
voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
</p>