-
Notifications
You must be signed in to change notification settings - Fork 78
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Algorithms should be <dfn> in prose instead of linked to headers #618
Comments
The same applies to several other links. It looks like adding |
That's a correct thing to do. (My personal preference is for headings to not be definitions, but they certainly can be.) |
I think that makes sense. The spec currently mixes the two approaches, and there are a few algorithms defined in headings. It makes sense to fix it and actually define them in text. Since some of them are exported, we should fix the references in the call sites (mostly html I think). I'll try to fix this. |
Linking to headers made sense to me at the time, but isn't what I'd do today given the tooling Bikeshed makes available. If I was writing it again, I'd use the " |
Sounds good to me as long as there is somewhere I can click and see where a certain algorithm is referenced. And consistency helps too. |
I went through the whole spec, since there are quite a few algorithms in headers (in particular, all the directive checks), I think the easiest thing to do is to just add dfn everywhere. |
The header "Does url match source list in origin with redirect count?" should be clickable and link to its references.
The text was updated successfully, but these errors were encountered: