Skip to content

Conversation

@wbamberg
Copy link
Collaborator

I'd like to link to a glossary definition of "registrable domain" in the passkeys guide. It turns out that although we don't have one, we do have a page for eTLD.

But I think "registrable domain" is a better glossary entry, for three reasons:

  • "registrable domain" is the spec term. The spec doesn't talk about eTLD AFAICT.
  • "registrable domain" is more comprehensible
  • we never actually link to "eTLD" we only link to "eTLD+1", which is the same as registrable domain. So we currently have to link into a fragment of the glossary entry, rather than directly to it.

@wbamberg wbamberg requested review from a team as code owners December 31, 2025 19:31
@wbamberg wbamberg requested review from dipikabh and hamishwillee and removed request for a team December 31, 2025 19:31
@github-actions github-actions bot added Content:WebAPI Web API docs Content:Other Any docs not covered by another "Content:" label Content:HTTP HTTP docs Content:Glossary Glossary entries Content:Firefox Content in the Mozilla/Firefox subtree size/m [PR only] 51-500 LoC changed labels Dec 31, 2025
@github-actions
Copy link
Contributor

Preview URLs (15 pages)
Flaws (6)

Note! 12 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/Attribution_Reporting_API
Title: Attribution Reporting API
Flaw count: 1

  • unknown:
    • Error parsing /shared-assets/images/diagrams/api/attribution-reporting/ara-flow.svg: No such file or directory (os error 2)

URL: /en-US/docs/Web/API/Private_State_Token_API/Using
Title: Using the Private State Token API
Flaw count: 2

  • macros:
    • Macro domxref produces link /en-US/docs/Web/API/fetch which is a redirect
    • Macro domxref produces link /en-US/docs/Web/API/fetch which is a redirect

URL: /en-US/docs/Web/HTTP/Reference/Headers/Attribution-Reporting-Register-Source
Title: Attribution-Reporting-Register-Source header
Flaw count: 3

  • unknown:
    • No generic content config found
    • no blog root
    • no blog root
External URLs (5)

URL: /en-US/docs/Glossary/Registrable_domain
Title: Registrable domain


URL: /en-US/docs/Mozilla/Firefox/Releases/92
Title: Firefox 92 release notes for developers


URL: /en-US/docs/Web/API/Private_State_Token_API/Using
Title: Using the Private State Token API

@wbamberg wbamberg changed the title Add glossary registrable domain instead of eTLD Add glossary page for registrable domain instead of eTLD Jan 1, 2026
@wbamberg wbamberg changed the title Add glossary page for registrable domain instead of eTLD Add glossary page for "registrable domain" instead of "eTLD" Jan 1, 2026
@wbamberg wbamberg mentioned this pull request Jan 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:Firefox Content in the Mozilla/Firefox subtree Content:Glossary Glossary entries Content:HTTP HTTP docs Content:Other Any docs not covered by another "Content:" label Content:WebAPI Web API docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant