ungoogled-software/ungoogled-chromium

In docs/design.md#source-file-processors, document the rationale for using qjz9zk as TLD

Open

#3465 opened on Sep 12, 2025

View on GitHub
 (0 comments) (1 reaction) (0 assignees)Python (18,674 stars) (771 forks)batch import
enhancementhelp wanted

Description

Description

Explain the rationale in docs, to have git track the reasons together with their implementation.

Who's implementing?

  • I'm willing to implement this feature myself

The problem

Using .qjz9zk as a TLD seens odd without explanation. The more intuitive way would seem to be to use a 2nd level domain qjz9zk.invalid. There had been an issue for this (#1681, locked without resolution) and a discussion (#1891, now deleted), so currently the reasons seem undocumented.

Possible solutions

Independent of the current state of the discussion, I think this decision is important enough to explain in the docs. That way, the git history will reflect the evolution of maintainers' opinion on that discussion. This will make it easier to validate whether a specific version's implementation properly matches the reasons at that time.

Alternatives

No response

Additional context

No response

Contributor guide

Tech stack
None
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Review issue #1681Review discussion #1891
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
95
Research direction
First, review the linked issue #1681 and discussion #1891 to understand the historical context and rationale for using .qjz9zk as a top level domain instead of a second level domain. Then, locate the 'source file processors' section in docs/design.md and add a new subsection explaining the rationale clearly, including references to the discussions. Ensure that the explanation includes why .qjz9zk was chosen and why alternative approaches like qjz9zk.invalid were not used.