tldr-pages / tldr

📚 Collaborative cheatsheets for console commands
https://tldr.sh
Other
51.09k stars 4.21k forks source link

Page translation request: outdated or missing Indonesian pages #13572

Open sebastiaanspeck opened 2 months ago

sebastiaanspeck commented 2 months ago

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

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.

reinhart1010 commented 2 months ago

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 commented 2 months ago

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.

reinhart1010 commented 3 days ago

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