Re: [w3c/ServiceWorker] Editorial: Revise reference links with bikeshed (PR #1762)

@yoshisatoyanagisawa commented on this pull request.



> @@ -88,6 +88,12 @@ spec: ecma-262; urlPrefix: https://tc39.es/ecma262/
             text: statement
             text: declaration
 
+spec: html; urlPrefix: https://html.spec.whatwg.org/

There are actually four ways to create a link to other specification:
1. W3C standard exports, and use it directly `[=something=]`, which might be what you recommend.
2. the "anchors" block to explain the combination of spec and text to be linked.  Then, use it in the .bs file.
3. `[=something=](https://example.com)` style link to directly add a link.
4. `<a href="https://example.com">something</a>` to directly add a link.

How do you use them differently?  Or, are there a style guide or so to explain the recommended way?  In https://github.com/w3c/ServiceWorker/pull/1760#issuecomment-2735224987, I suggested to modify 3 and 4 to either of 1 or 2.  I am quite sure that brought this change.

-- 
Reply to this email directly or view it on GitHub:
https://github.com/w3c/ServiceWorker/pull/1762#discussion_r2013364602
You are receiving this because you are subscribed to this thread.

Message ID: <w3c/ServiceWorker/pull/1762/review/2715861478@github.com>