Skip to content
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

Page translation request: outdated or missing Indonesian pages #13572

Open
sebastiaanspeck opened this issue Sep 2, 2024 · 3 comments
Open
Labels
good first issue Recommended issues for first-time contributors help wanted You can help make tldr-pages better! translation Translate pages from one language to another.

Comments

@sebastiaanspeck
Copy link
Member

sebastiaanspeck commented Sep 2, 2024

Right now (2024-09-02) there are:

  • 135 missing alias page(s) in check-pages.id/missing-id-alias-pages.txt.
  • 166 missing TLDR page(s) in check-pages.id/missing-tldr-id-commands.txt.
  • 33 outdated page(s) based on number of commands in check-pages.id/outdated-id-pages-based-on-command-count.txt.
  • 19 outdated page(s) based on the commands itself in check-pages.id/outdated-id-pages-based-on-command-contents.txt.

This is according to https://github.com/tldr-pages/tldr-maintenance. I see we are constantly adding new pages, which is great, but if we keep this stack above building up, it won’t be feasible to fix these issues anymore.
Therefore I would like to open this request to call Indonesian maintainers to keep the Indonesian pages up-to-date, besides adding new pages.

@reinhart1010

Note

This issue is for Indonesian only, but I could open way more issues for all other CODEOWNER-maintained languages. I want to mention again how useful https://github.com/tldr-pages/tldr-maintenance is to me. I can check very quickly if I have to do any work on updating the Dutch pages e.g., or if we have to run set-more-info-link.py e.g.

@sebastiaanspeck sebastiaanspeck added help wanted You can help make tldr-pages better! translation Translate pages from one language to another. labels Sep 2, 2024
@reinhart1010
Copy link
Collaborator

reinhart1010 commented Sep 3, 2024

166 missing TLDR page(s) in check-pages.id/missing-tldr-id-commands.txt.

What was the criteria behind this selection of commands? I usually benchmark with the tldr translation progress data for English, German, and Spanish to prioritize translating those who are already translated in these languages.

Based on my past experiences it takes about 40-50 new pages to raise the translation coverage by 1% (of all pages on all platforms). So I expect the set of missing commands should be thousands more than the ones listed here.

@sebastiaanspeck
Copy link
Member Author

166 missing TLDR page(s) in check-pages.id/missing-tldr-id-commands.txt.

What was the criteria behind this selection of commands? I usually benchmark with the tldr translation progress data for English, German, and Spanish to prioritize translating those who are already translated in these languages.

Based on my past experiences it takes about 40-50 new pages to raise the translation coverage by 1% (of all pages on all platforms). So I expect the set of missing commands should be thousands more than the ones listed here.

A command is marked as a missing TLDR page, when it is mentioned in a page (tldr {{command}}) but the referenced command doesn't have a (translated) page.
There are 4563 pages missing in total for Indonesian, but we can't expect you to add all those pages in a single iteration.

https://github.com/tldr-pages/tldr-maintenance/blob/eb4f8f9375159ee877db54ecbb266802617fc23a/metrics.log#L151 - the tldr-maintenance repo is more extensive than the tldr translation progress data; also see the README.

The way I work is to watch the tldr-maintenance repo for my maintained language (Dutch) to see if I need to do anything to the pile; e.g.:

0 inconsistent filename(s) in check-pages.nl/inconsistent-nl-filenames.txt.
0 malformed or outdated more info link page(s) in check-pages.nl/malformed-or-outdated-more-info-link-nl-pages.txt.
0 missing alias page(s) in check-pages.nl/missing-nl-alias-pages.txt.
0 mismatched page title(s) in check-pages.nl/mismatched-nl-page-titles.txt.
0 missing TLDR page(s) in check-pages.nl/missing-tldr-nl-commands.txt.
0 misplaced page(s) in check-pages.nl/misplaced-nl-pages.txt.
0 outdated page(s) based on number of commands in check-pages.nl/outdated-nl-pages-based-on-command-count.txt.
2 outdated page(s) based on the commands itself in check-pages.nl/outdated-nl-pages-based-on-command-contents.txt.
0 missing English page(s) in check-pages.nl/missing-english-nl-pages.txt.
4089 missing translated page(s) in check-pages.nl/missing-translated-nl-pages.txt.
0 linter error(s) in check-pages.nl/lint-errors-nl.txt.

The big pile of 4089 missing translated pages will slowly shrink.

@sebastiaanspeck sebastiaanspeck added the good first issue Recommended issues for first-time contributors label Sep 7, 2024
@reinhart1010
Copy link
Collaborator

Hi, after researching about this, I would propose of using like this alongside outdated and "missing linked/alias pages" detections to organize contributions, based on the imminence levels (i.e. how much translations are currently available for an untranslated page).

As I've tested out today, most of the pages are only translated in up to 2 languages. So contributions on lower-level pages is still welcome to push up the pages into priority for other language maintainers.

*of translated pages (excluding those already translated and not outdated in Indonesian)

Level/Rank Number* Examples
18 1 common/tldr
14 1 common/grep
13 6 common/chsh, common/mkdir, windows/choco
12 1 windows/cmd
11 14 common/awk, common/tar, linux/a2disconf
10 12 common/cargo, linux/a2enconf, linux/systemctl
9 15 common/zsh, linux/archinstall, windows/choco-info
8 27 common/dotnet, osx/caffeinate, windows/title
7 52 common/docker-inspect, common/htop, linux/flatpak
6 99 common/cmake, common/wget, osx/diskutil
5 145 common/firefox, freebsd/chpass, osx/dark-mode
4 264 common/magick, linux/xdg-open, osx/xcode-select
3 739 common/gitlab, osx/launchctl, windows/pwd
2 1621 common/brotli, windows/move-item, windows/netstat
1 1718 common/kdenlive, linux/engrampa, windows/clear-recyclebin

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Recommended issues for first-time contributors help wanted You can help make tldr-pages better! translation Translate pages from one language to another.
Projects
None yet
Development

No branches or pull requests

2 participants