-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.html
206 lines (185 loc) · 5.89 KB
/
index.html
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
<!doctype html>
<html>
<head>
<title>Unconventions</title>
<!-- Hachi Maru Pop (Google font) -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Hachi+Maru+Pop&display=swap" rel="stylesheet">
<style>
body {
align-items: center;
background-color: #111;
background-image: url("sketches/sketch.png");
}
header, main, footer {
margin: auto;
margin-top: 32px;
margin-bottom: 32px;
width: clamp(256px, 60%, 512px);
padding: 32px;
border-radius: 32px 0;
}
header {
text-align: center;
background-color: #fca;
}
header, footer, h1, h2, h3 {
font-family: 'Hachi Maru Pop', cursive;
}
main {
font-family: Trebuchet, sans;
background-color: #eef;
}
footer {
text-align: center;
background-color: #fca;
}
a {
font-weight: bold;
text-decoration: none;
color: orangered;
}
</style>
</head>
<body>
<header>
<h1>Unconventions: 無限</h1>
<p>The forever-unconventional convention</p>
</header>
<main>
<h2>Hey, you, internet person!</h2>
<p>
It's ok to <em>not follow</em> common conventions. A project that follows
"unconventions" is choosing to opt out of one or more common conventions.
<p>
<p>
Perhaps they use a more obscure convention, or no convention at all.
Maybe it's all explained, and maybe it's not. Anyway, it's a valid
choice.
</p>
<h2>But but but...!</h2>
<p>
Ok, I know, I know, someone made a nice website! They told the world that
everyone should do <a href="https://semver.org/">Semantic Versioning</a>,
<a href="https://www.conventionalcommits.org">Conventional Commits</a>, and
also they should <a href="https://keepachangelog.com">Keep a Changelog</a>.
The website looks polished, the idea sounds better than alternatives, and
wow the <em>convention</em> itself even has a version! Everyone obviously
has to adopt it and <b>we should flame the lazy bums that don't follow
the rules,</b> right?
</p>
<p>
<b>No.</b> Stop that.
</p>
<p>
Conventions are optional. They're fine if you like them, and often
helpful if other people you're interacting with follow them. Not everyone
will follow every convention that comes along, and hey, <em>that's a good
thing!</em> Every new and good convention came about because someone was
not following some older and worse conventions. (Of course: old ≢ bad)
</p>
<p>
It's also fine to not be so serious all the time, and sometimes do stuff,
you know, "<a href="https://justforfunnoreally.dev">Just for Fun. No,
really.</a>"
</p>
<p>
If someone comes to you and asks why you don't follow <em><insert
convention here></em> you can say that you choose to follow
Unconventions. If they're persistent and ask for a version, you can say
version 無限. All versions of unconventions should be considered the
same version. Version "v1.0" and version "banana" are also the same as
version 無限 by convention.
</p>
<hr>
<h1>Addendum</h1>
<br>
<h2 id="badge">
1: Display the badge
<a href="#badge">🖇</a>
</h2>
<p>
<img src="https://img.shields.io/badge/unconventions-%E7%84%A1%E9%99%90-orange">
</p>
<p>
As Markdown:
</p>
<pre style="overflow:scroll;">
[](https://unconventions.org)
</pre>
<br>
<h2 id="counter-convention">
2: Counter convention
<a href="#counter-convention">🖇</a>
</h2>
<p>
Unconventions is not <em>against</em> conventions, but it carries a
spirit that is willing to listen to, and amplify, well-meaning critiques
of conventions. The following lists are intended to push conventions
forward, either to improve or to foster discussion that leads to newer
and better conventions.
<p>
<br>
<h3>Semantic Versioning</h3>
<p><a href="https://semver.org">https://semver.org</a></p>
<p>Critiques</p>
<ul>
<li>
<a href="https://youtu.be/oyLBGkS5ICk?t=1792">
"Semantic" Versioning "Semantics"
</a> from Rich Hickey's 2016 Clojure/conj keynote.
</li>
<li>
<a href="https://jolynch.github.io/posts/semver_considered_harmful/">
SemVer Considered Harmful
</a> by Joey Lynch
</li>
<li>
<a href="https://surfingthe.cloud/semantic-versioning-anti-pattern/">
The Semantic Versioning Anti-Pattern
</a> by Brandon Gillespie
</li>
<li>
<a href="https://agingdeveloper.com/article/2022-02-26-major-harmful">
Major Versions Considered Harmful?
</a> by Richard Klein
</li>
</ul>
<br>
<h3>Calendar Versioning</h3>
<p><a href="https://calver.org">https://calver.org</a></p>
<p>Critiques</p>
<ul>
<li>Coming soon...?</li>
</ul>
<br>
<h3>Conventional Commits</h3>
<p><a href="https://www.conventionalcommits.org">https://www.conventionalcommits.org</a></p>
<p>Critiques</p>
<ul>
<li>Coming soon...?</li>
</ul>
<br>
<h3>Keep a Changelog</h3>
<p><a href="https://keepachangelog.com">https://keepachangelog.com</a></p>
<p>Critiques</p>
<ul>
<li>Coming soon...?</li>
</ul>
</main>
<footer>
<p>
Since 2023, by <a href="https://so.dang.cool">J.R. Hill</a>.
</p>
<p>
<a href="https://github.com/so-dang-cool/unconventions.org">Site source here</a>
</p>
</footer>
<!--
TODO:
- Link to lesiw's blog on semver considered harmful
- Some easter egg in the HTML source
-->
</body>
</html>