You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Abstract: An explainer introduces a problem that a group of people are trying to solve,
17
17
and helps everyone with an interest in the target problem find consensus on a good way to solve it.
18
18
@@ -143,6 +143,15 @@ Link to all prior art in either
143
143
your [considered alternatives](https://github.com/w3ctag/tag.w3.org/blob/main/explainers/template.md#considered-alternatives) section
144
144
or your [references and acknowledgements](https://github.com/w3ctag/tag.w3.org/blob/main/explainers/template.md#references--acknowledgements).
145
145
146
+
## Enable Easy Deep Linking ## {#deep-linking}
147
+
148
+
You should host your explainer as HTML at a stable, readable URL,
149
+
ideally next to where the specification is expected to land.
150
+
Use a format
151
+
that makes it easy for reviewers to link directly to sections inside the document,
152
+
like Markdown or HTML.
153
+
It's fine to use a host like GitHub that automatically renders Markdown.
154
+
146
155
----
147
156
148
157
By following these guidelines, you can create clear, concise, and accessible explainers that effectively communicate your proposed web standards specifications for W3C TAG review.
0 commit comments