Skip to content

Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.

README: name README.tr.md in the theme guide and press tests

Bilal Vuralaeadfc6613be
diff --git a/AGENTS.md b/AGENTS.md
index 018b82dc2..48f24381e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -71,7 +71,7 @@ share their TV's list afterwards, follow [`docs/workflows/tv-list.md`](docs/work
| Path | What it is |
|---|---|
| `PROMPT.md` | The prompt people paste into their agent. Brand-neutral; safety rules live here. |
-| `README.md` | Front page, with the brand grid (generated from `examples/*/tv.json` by `tools/gen_tables.py`) and the Tools table. Longer guides it links live in `docs/`: `launcher.md`, `restore.md`, `firmware-updates.md`, `privacy.md` and `faq.md`. `README.zh-CN.md` and `README.vi.md` are translations. |
+| `README.md` | Front page, with the brand grid (generated from `examples/*/tv.json` by `tools/gen_tables.py`) and the Tools table. Longer guides it links live in `docs/`: `launcher.md`, `restore.md`, `firmware-updates.md`, `privacy.md` and `faq.md`. `README.<lang>.md` are its translations (`zh-CN`, `zh-TW`, `vi`, `ja`, `it`, `nl`, `de`, `uk`, `tr`). |
| `CONTRIBUTING.md` | The contributor guide for people. "Where does my idea go?" is the routing table. |
| `SECURITY.md` | Private vulnerability reporting. |
| `SHOWCASE.md` | Projects built on this repo that live in their own repositories. |
diff --git a/docs/workflows/theme.md b/docs/workflows/theme.md
index 5fe60acef..323489ec2 100644
--- a/docs/workflows/theme.md
+++ b/docs/workflows/theme.md
@@ -12,13 +12,13 @@
Home with the focus on the dock: a JPEG at 1280x720 (16:9), at most 300 KB. Not a mock-up, not an
emulator. `tests/test_themes.py` fails without it.
4. Add a row to the table in `themes/README.md` showing the screenshot, like the others.
-5. Bump the count in the Themes feature row of every front page that states it: today `README.md`
- ("`N ship in themes/`"), `README.de.md`, `README.nl.md`, `README.uk.md` and `README.tr.md` (in
- digits), each in its own words; the five are today's pages rather than the rule. `tests/test_readme_theme_count.py` counts
- the folders that carry a `config.json` and fails on a page whose number is not that count, naming
- the page and the folders (`README.nl.md says 10 themes and themes/ holds 11: aurora, ...`). A
- language whose number words the test does not carry yet is a page it cannot read, so a new
- translation that states the count needs those words in its table.
+5. Bump the count in the Themes feature row of every front page that states it: today `README.md` ("`N ship
+ in themes/`"), `README.de.md`, `README.nl.md`, `README.uk.md` and `README.tr.md` (in digits), each in its
+ own words; the five are today's pages rather than the rule. `tests/test_readme_theme_count.py` counts the
+ folders that carry a `config.json` and fails on a page whose number is not that count, naming the page
+ and the folders (`README.nl.md says 10 themes and themes/ holds 11: aurora, ...`). A language whose
+ number words the test does not carry yet is a page it cannot read, so a new translation that states the
+ count needs those words in its table.
6. A look that needs a new key is a launcher switch first, in its own PR.
Then run the tests: `python3 -m unittest discover -s tests -v`.
diff --git a/docs/workflows/translation.md b/docs/workflows/translation.md
index 08a533582..9027643d4 100644
--- a/docs/workflows/translation.md
+++ b/docs/workflows/translation.md
@@ -40,7 +40,8 @@
checks that `layout-iw` keeps every view.
9. The language count moves with the folder. `README.md`, `README.nl.md`, `README.de.md`, `README.uk.md` and
`README.tr.md` state it in the card's alt text and in the `| **N languages** |` row, and
- `tools/readme_stats.py`'s `STATS` carries it for the pictures, so a language added without them leaves those pages and the card claiming the old number.
+ `tools/readme_stats.py`'s `STATS` carries it for the pictures, so a language added without them leaves
+ those pages and the card claiming the old number.
`tests/test_gen_tables_translated_counts.py` fails on the translated page in the meantime ('355 tv-modellen ·
97 merken · 30 talen · ' != '… 29 talen · '). Run `python3 tools/gen_tables.py` after adding the folder: it
moves the number in the pages it writes and in `STATS`, prints that `docs/stats.png` and `docs/card.jpg` have
diff --git a/tests/test_press_counts.py b/tests/test_press_counts.py
index d5342839b..76829b2db 100644
--- a/tests/test_press_counts.py
+++ b/tests/test_press_counts.py
@@ -1,8 +1,9 @@
"""Keeps the press numbers in docs/PRESS.md, the README cards and the card source in step.
The article total is written in every place that states it: the PRESS.md intro, its per-country index
-line, the alt text of the card in README.md, the alt text of the same card in README.nl.md (in Dutch)
-and in README.de.md (in German), and tools/readme_featured.py (which draws the line onto
+line, the alt text of the card in README.md, the alt text of the same card in README.nl.md (in Dutch),
+README.de.md (in German), README.uk.md (in Ukrainian) and README.tr.md (in Turkish), and
+tools/readme_featured.py (which draws the line onto
docs/featured.png). Adding one article by hand means editing all of them; this checks they agree, so a
PR that adds a row and forgets the counts fails here instead of shipping a card that says 73 over a
list of 74.
@@ -436,8 +437,8 @@ class FrontPageCoverageTest(unittest.TestCase):
# The clause is the page's own copy of the three numbers its card's alt text states, so one page can show
# a count in the picture and a stale one in prose; the pages come from the card, like the alt-text test, so
# a translation that copies the picture is read without this list being edited first.
- self.assertLessEqual({"README.md", "README.de.md", "README.nl.md", "README.uk.md"}, set(self.pages),
- "README.md, README.de.md, README.nl.md and README.uk.md no longer show "
+ self.assertLessEqual({"README.md", "README.de.md", "README.nl.md", "README.uk.md", "README.tr.md"}, set(self.pages),
+ "README.md, README.de.md, README.nl.md, README.uk.md and README.tr.md no longer show "
"docs/card-halloween.jpg with an alt text")
for name in sorted(self.pages):
read = coverage_numbers((ROOT / name).read_text(encoding="utf-8"))
@@ -454,7 +455,7 @@ class FrontPageCoverageTest(unittest.TestCase):
# A reader answering () or None for every page would pass nothing above; each page carries three
# numbers today, and the English one is the page this file's own example is quoted from.
self.assertGreaterEqual(len(self.pages), 4, f"only {len(self.pages)} front pages show the card")
- for name in ("README.md", "README.de.md", "README.nl.md", "README.uk.md"):
+ for name in ("README.md", "README.de.md", "README.nl.md", "README.uk.md", "README.tr.md"):
read = coverage_numbers((ROOT / name).read_text(encoding="utf-8"))
with self.subTest(readme=name):
self.assertEqual(3, len(read or ()), f"{name}'s coverage sentence reads as {read}")
@@ -472,8 +473,8 @@ class FrontPageTotalsTest(unittest.TestCase):
# picture and 380 in the story two screens below it. A contributor adding a list folder edits
# neither (docs/workflows/tv-list.md step 5 leaves the tables to a maintainer), so this only bites
# the run that regenerates the card.
- self.assertLessEqual({"README.md", "README.de.md", "README.nl.md", "README.uk.md"}, set(self.pages),
- "README.md, README.de.md, README.nl.md and README.uk.md no longer show "
+ self.assertLessEqual({"README.md", "README.de.md", "README.nl.md", "README.uk.md", "README.tr.md"}, set(self.pages),
+ "README.md, README.de.md, README.nl.md, README.uk.md and README.tr.md no longer show "
"docs/card-halloween.jpg with an alt text")
for name in sorted(self.pages):
card = card_totals(self.pages[name])
@@ -493,7 +494,7 @@ class FrontPageTotalsTest(unittest.TestCase):
# A reader answering () or None for every page would pass the rule above; each page carries two
# numbers today, and README.md is the page this file's own example is quoted from.
self.assertGreaterEqual(len(self.pages), 4, f"only {len(self.pages)} front pages show the card")
- for name in ("README.md", "README.de.md", "README.nl.md", "README.uk.md"):
+ for name in ("README.md", "README.de.md", "README.nl.md", "README.uk.md", "README.tr.md"):
read = catalogue_numbers((ROOT / name).read_text(encoding="utf-8"))
with self.subTest(readme=name):
self.assertEqual(2, len(read or ()), f"{name}'s story sentence reads as {read}")
diff --git a/tests/test_readme_quick_start_clone.py b/tests/test_readme_quick_start_clone.py
index ea7a10e9c..15111f93f 100644
--- a/tests/test_readme_quick_start_clone.py
+++ b/tests/test_readme_quick_start_clone.py
@@ -110,7 +110,8 @@ class TheCloneStep(unittest.TestCase):
def test_every_readme_is_read(self):
found = pages()
- self.assertEqual(10, len(found), f"expected README.md and nine translations, read {[p.name for p in found]}")
+ self.assertGreaterEqual(len(found), 10,
+ f"expected README.md and at least nine translations, read {[p.name for p in found]}")
for page in found:
self.assertGreaterEqual(len(rows(page.read_text(encoding="utf-8"))), 3,
f"{page.name} parses as fewer than three table rows")
diff --git a/tests/test_readme_theme_count.py b/tests/test_readme_theme_count.py
index 9ade2c7b1..36dc812a7 100644
--- a/tests/test_readme_theme_count.py
+++ b/tests/test_readme_theme_count.py
@@ -23,8 +23,10 @@ one table of the words these four languages state a number in, so a theme folder
this test with that page, and a page that starts stating the count is held the same way. A word the
table does not carry names the page that wrote it rather than reading as no claim at all; one is left
out of the table on purpose, since "een" and "ein" are also the articles these languages put before a
-noun, and a single-theme repo is not a thing. A fifth language means a fifth line in that table: the
-last page added did not fail here, it simply became a page this file could not see.
+noun, and a single-theme repo is not a thing. Another language that writes the count as a word means
+another line in that table: the last page added did not fail here, it simply became a page this file
+could not see. README.tr.md, the fifth page, writes it in digits ("15 tema"), which NUMBER reads
+without a table line.
That one table is what README.md's row is read through too. The row had a twelve-word table of its own
while the sentences were read through one that carries twenty, and the two agreed only while themes/
@@ -54,8 +56,8 @@ ROW_START = "| **Themes** |"
# Every feature row that names themes/ and states how many ship there, whatever language it is in:
# English "eleven ship in", German "Zehn liegen in", Dutch "staan tien thema's", Ukrainian
-# "постачається чотирнадцять". The words come from the four languages the front pages are written in
-# today, two to twenty each; one is left out because "een" and "ein" are also the articles those
+# "постачається чотирнадцять". The words come from the four languages whose front pages write the
+# count as a word today (README.tr.md writes digits), two to twenty each; one is left out because "een" and "ein" are also the articles those
# languages put before a noun, so an English "one" would read a Dutch sentence as a claim of one theme.
NUMBER_WORDS = {"two": 2, "three": 3, "four": 4, "five": 5, "six": 6, "seven": 7, "eight": 8,
"nine": 9, "ten": 10, "eleven": 11, "twelve": 12,
diff --git a/themes/CREATE_A_THEME.md b/themes/CREATE_A_THEME.md
index 2cc419d37..53c5325c8 100644
--- a/themes/CREATE_A_THEME.md
+++ b/themes/CREATE_A_THEME.md
@@ -108,12 +108,12 @@ Add one row to the table in [`themes/README.md`](README.md):
| [`retro/`](retro/) | What it looks like in one line | <img src="retro/screenshot.jpg" width="320" alt="retro theme"> |
```
-Then bump the count in the Themes feature row of every front page that states it: `README.md`
-("`N ship in themes/`"), `README.de.md`, `README.nl.md` and `README.uk.md`, each in its own words. The
-four are today's pages rather than the rule. `tests/test_readme_theme_count.py` counts the folders here
-that carry a `config.json` and fails on a page whose number is not that count, naming the page and the
-folders (`README.de.md says 14 themes and themes/ holds 15: aurora, ...`), so the page you leave behind
-is the one that stops the PR.
+Then bump the count in the Themes feature row of every front page that states it: `README.md` ("`N ship in
+themes/`"), `README.de.md`, `README.nl.md`, `README.uk.md` and `README.tr.md` (in digits), each in its own
+words. The five are today's pages rather than the rule. `tests/test_readme_theme_count.py` counts the
+folders here that carry a `config.json` and fails on a page whose number is not that count, naming the page
+and the folders (`README.de.md says 14 themes and themes/ holds 15: aurora, ...`), so the page you leave
+behind is the one that stops the PR.
## 7. Open the pull request