Skip to content

Add TLDR113 to check all lines in translated page are translated - #457

Draft
sebastiaanspeck wants to merge 15 commits into
mainfrom
add-TLDR022-and-TLDR112
Draft

Add TLDR113 to check all lines in translated page are translated#457
sebastiaanspeck wants to merge 15 commits into
mainfrom
add-TLDR022-and-TLDR112

Conversation

@sebastiaanspeck

@sebastiaanspeck sebastiaanspeck commented Jan 2, 2026

Copy link
Copy Markdown
Member

Translated lines must not be identical to English page lines (only lines starting with > and - are checked) tldr-pages/tldr#20485 (comment)

- Label for see also mention should be spelled exactly `See also:`
- Translated lines must not be identical to English page lines (only lines starting with `>` and `-` are checked) tldr-pages/tldr#20485 (comment)
Comment thread lib/tldr-lint.js Fixed
…tion

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
@sebastiaanspeck
sebastiaanspeck force-pushed the add-TLDR022-and-TLDR112 branch from b3e6647 to 746fcfc Compare January 2, 2026 10:05
@sebastiaanspeck sebastiaanspeck changed the title Add TLDR022 and TLDR112 Add TLDR112 to check all lines in translated page are translated Jan 2, 2026
@sebastiaanspeck

This comment has been minimized.

@sebastiaanspeck
sebastiaanspeck marked this pull request as draft January 2, 2026 10:50
@Managor

Managor commented Jan 2, 2026

Copy link
Copy Markdown
Member

If all words start with capital öetters, disregard it.

@sebastiaanspeck

Copy link
Copy Markdown
Member Author

If all words start with capital letters, disregard it.

I don't think that is waterproof.

@Managor

Managor commented Jan 2, 2026

Copy link
Copy Markdown
Member

Ok, you're right. I checked a couple more pages like fastd and pip
image
image

The "package manager" should be translated though.

@sebastiaanspeck

Copy link
Copy Markdown
Member Author

Ok, you're right. I checked a couple more pages like fastd and pip
image image

The "package manager" should be translated though.

Agreed.

@Managor

Managor commented Jan 2, 2026

Copy link
Copy Markdown
Member

Hmmm. Although checking if every word has a capital first letter does prune the list considerably. From what I quickly checked, many of these are just that. BIRD, MPD and OBS were a couple I picked as a scattershot and they would have been filtered

@sebastiaanspeck

sebastiaanspeck commented Jan 2, 2026

Copy link
Copy Markdown
Member Author

Hmmm. Although checking if every word has a capital first letter does prune the list considerably. From what I quickly checked, many of these are just that. BIRD, MPD and OBS were a couple I picked as a scattershot and they would have been filtered

Will implement it and publish the new list here:

pages.de/common/fastd.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.de/common/pip.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.es/osx/mist.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.es/windows/uwfmgr.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.fr/common/ansible-inventory.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/chatgpt.md:26: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/clang++.md:4: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/clang.md:4: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/frpc.md:15: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/laravel.md:14: TLDR112 Translated lines must not be identical to English page lines
pages.id/sunos/svcs.md:22: TLDR112 Translated lines must not be identical to English page lines
pages.it/common/drill.md:10: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/aws-cognito-idp.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/cargo-clippy.md:18: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/cargo-tree.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/cdk.md:10: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/certutil.md:22: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/exenv.md:18: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/fossil-commit.md:18: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/helm-install.md:26: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/ignite.md:18: TLDR112 Translated lines must not be identical to English page lines
pages.ko/linux/sam.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.ko/osx/mist.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/android/cmd.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/ani-cli.md:35: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/crane-rebase.md:6: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/dunst.md:7: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/fzf.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/luanti.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/mpicc.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/php.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/ping.md:6: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/tmux.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.pt_BR/common/zip.md:31: TLDR112 Translated lines must not be identical to English page lines
pages.tr/linux/pw-link.md:14: TLDR112 Translated lines must not be identical to English page lines

@Managor

Managor commented Jan 2, 2026

Copy link
Copy Markdown
Member

That seems a bit more manageable. Can you check the Dutch mistakes to cut down the list even further? Once we get a list of only false positives, it'll be easier to create heuristics for this sort of thing.
Once Dutch is done, we can create an issue tracker for the translators

@sebastiaanspeck

Copy link
Copy Markdown
Member Author

That seems a bit more manageable. Can you check the Dutch mistakes to cut down the list even further? Once we get a list of only false positives, it'll be easier to create heuristics for this sort of thing.

Once Dutch is done, we can create an issue tracker for the translators

Opened tldr-pages/tldr#20516. Another exception could be to ignore it if the line only consists out of 2 (or maybe even 3) words. Then we would ignore lines like:

@sebastiaanspeck

sebastiaanspeck commented Jan 3, 2026

Copy link
Copy Markdown
Member Author

With ignoring lines shorter than two words, we will have 28 issues to fix.
With ignoring lines shorter than three words, we will have 22 issues to fix.

(Without ignoring lines based on a word-count, we would've had 34 issues to fix)

Ignoring lines shorter than two words:

pages.de/common/pip.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.es/osx/mist.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.es/windows/uwfmgr.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.fr/common/ansible-inventory.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/chatgpt.md:26: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/clang++.md:4: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/clang.md:4: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/frpc.md:15: TLDR112 Translated lines must not be identical to English page lines
pages.id/common/laravel.md:14: TLDR112 Translated lines must not be identical to English page lines
pages.id/sunos/svcs.md:22: TLDR112 Translated lines must not be identical to English page lines
pages.it/common/drill.md:10: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/aws-cognito-idp.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/cargo-clippy.md:18: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/cargo-tree.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/cdk.md:10: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/certutil.md:22: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/exenv.md:18: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/fossil-commit.md:18: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/helm-install.md:26: TLDR112 Translated lines must not be identical to English page lines
pages.ko/common/ignite.md:18: TLDR112 Translated lines must not be identical to English page lines
pages.ko/linux/sam.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.ko/osx/mist.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/android/cmd.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/luanti.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/mpicc.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.nl/common/php.md:3: TLDR112 Translated lines must not be identical to English page lines
pages.pt_BR/common/zip.md:31: TLDR112 Translated lines must not be identical to English page lines
pages.tr/linux/pw-link.md:14: TLDR112 Translated lines must not be identical to English page lines

@sebastiaanspeck sebastiaanspeck changed the title Add TLDR112 to check all lines in translated page are translated Add TLDR113 to check all lines in translated page are translated Jan 4, 2026
Comment thread README.md Outdated
@sebastiaanspeck

Copy link
Copy Markdown
Member Author

Opened tldr-pages/tldr#20542 to address remaining issues.

@Managor

Managor commented Jan 4, 2026

Copy link
Copy Markdown
Member

In a similar vein to this, we could create a checker to see if the English page contains "- Display help:" or "- Display version:" and make sure that the translation matches the template.

@sebastiaanspeck

Copy link
Copy Markdown
Member Author

In a similar vein to this, we could create a checker to see if the English page contains "- Display help:" or "- Display version:" and make sure that the translation matches the template.

Although this is very closely related to the contributing-guides, if the required contributing guide doesn't exist in the expected folder structure, this check will fail.

Similar to this, I sometimes see path changing to path/to/file, but the translation being behind.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants