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 Portuguese Brazilian pages #13575

Open
sebastiaanspeck opened this issue Sep 2, 2024 · 17 comments
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:

  • 139 missing alias page(s) in check-pages.pt_BR/missing-pt_BR-alias-pages.txt.
  • 147 missing TLDR page(s) in check-pages.pt_BR/missing-tldr-pt_BR-commands.txt.
  • 75 outdated page(s) based on number of commands in check-pages.pt_BR/outdated-pt_BR-pages-based-on-command-count.txt.
  • 40 outdated page(s) based on the commands itself in check-pages.pt_BR/outdated-pt_BR-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 Portuguese Brazilian maintainers to keep the Portuguese Brazilian pages up-to-date, besides adding new pages.

@isaacvicente @vitorhcl

Note

This issue is for Portuguese Brazilian 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. good first issue Recommended issues for first-time contributors labels Sep 2, 2024
@sebastiaanspeck
Copy link
Member Author

@renie Hi, you seem to be enjoying making contributions for Brazilian Portuguese, is there maybe a chance you can look to the outdated pages? tldr-pages/tldr-maintenance#110 - I know it are a lot, but if we put some effort in now, I am sure we can keep the pile low in the future

@renie
Copy link
Member

renie commented Sep 23, 2024

Sure, @sebastiaanspeck . I will have a look at them.

@renie
Copy link
Member

renie commented Sep 23, 2024

first PR submitted for all the outdated linux commands based on the commands itself.

@renie
Copy link
Member

renie commented Sep 25, 2024

second PR submitted for all the outdated linux commands based on the number of commands.

@rffontenelle
Copy link
Contributor

rffontenelle commented Oct 2, 2024

Hi, I'd like to contribute translating to pt_BR as well. I'm think about starting with windows and osx out of date pages, and then move on to common pages (to not conflict with renie's work. Is it OK?

Also, a question: common has many pages, so one PR per page would be too noisy and I'm afraid that one PR for all may be too much pages in one. What's is the best approach?

@sebastiaanspeck
Copy link
Member Author

Hi, I'd like to contribute translating to pt_BR as well. I'm think about starting with windows and osx out of date pages, and then move on to common pages (to not conflict with renie's work. Is it OK?

Feel free to make a start!

Also, a question: common has many pages, so one PR per page would be too noisy and I'm afraid that one PR for all may be too much pages in one. What's is the best approach?

I think the best approach is one PR per platform. For your information this issue has outdated numbers, please refer to tldr-pages/tldr-maintenance#110 which is an up-to-date issue and will also be updated if you would resolve any outdated page.

@rffontenelle
Copy link
Contributor

For your information this issue has outdated numbers, please refer to tldr-pages/tldr-maintenance#110 which is an up-to-date issue and will also be updated if you would resolve any outdated page.

Thanks. I've spotted the aforementioned issue before. Congrats on the this very organized system, it was very easy to spot the contribution needed and how to contribute.

@renie
Copy link
Member

renie commented Oct 2, 2024

Hey @rffontenelle ! It is very nice to see someone else interested on helping with those translations.
About your questions on where to start. I am working on a PR for common and I have finished the linux part. I think it would be nice if you follow your own suggestion of starting with windows and osx, maybe even android ones.
And if you finish all of those before I finish the common ones, we can find an approach to work together on those. What do you think?

@rffontenelle
Copy link
Contributor

@renie thanks for letting me know. Ok, windows and osx first, then we coordinate.

@sebastiaanspeck
Copy link
Member Author

And if you want, there are two android pages outdated as well 😄

tldr-pages/tldr-maintenance#110 has been updated after the two PR’s from @renie have been merged.

@renie
Copy link
Member

renie commented Oct 2, 2024

It is very good to see those lists getting smaller 😌

@rafaelgpaves
Copy link
Contributor

Hi, I'd also like to contribute to translation. I see you're already working on windows, osx and common. Is it ok if I start working on missing alias pages in freebsd or maybe something outdated in common like mysql?

@renie
Copy link
Member

renie commented Oct 23, 2024

Sure, @rafaelgpaves ! freebsd ones seems to be a good place to start now. Once finished we can talk about common. Sounds good to you?

@rafaelgpaves
Copy link
Contributor

Sounds good! I'll start working on freebsd then.

@sebastiaanspeck
Copy link
Member Author

Sounds good! I'll start working on freebsd then.

Please check tldr-pages/tldr-maintenance#110, this one gets updated actively after every commit and shows the current progress.

@johnnywell
Copy link
Contributor

johnnywell commented Oct 26, 2024

Hello! I'd also like to contribute to the translation. Submititted my first PR: #14401 that fixes a broken a link and adds a 'deprecated' warning.

@renie
Copy link
Member

renie commented Oct 27, 2024

Hello! I'd also like to contribute to the translation. Submititted my first PR: #14401 that fixes a broken a link and adds a 'deprecated' warning.

Thanks, @johnnywell !

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

5 participants