The translation of this project is something really awesome, but some people cannot read a single word in English. Adding flags in the readme allows visual and quick access to translated versions.
๐ Problem
๐ฏ Goal
Have a visual and quick way to access translated versions
๐ก Possible solutions
Add flags with links to available translated versions in the README.md
๐ Steps to solve the problem
I imagine two approaches to do that.
[...]
๐ฎ๐ณ ๐ฒ๐ฒ ๐ฎ๐ฉ [...]
[...]
[...]
๐ฎ๐ณ เคนเคฟเคจเฅเคฆเฅ | ๐ฒ๐ฒ Myanmar Unicode | ๐ฎ๐ฉ Bahasa Indonesia [...]
[...]
What do you think about Folks? Which the best way to do this?
Thank you for opening this issue @OtacilioN ๐. I fully understand your point.
We used to have a listing of languages in Readme itself. We refactored it in to a separate file when it started getting bloated up.
One of the things we did with tutorial is to keep it very short. That really worked out too. That's why we removed translation links too.
Let's wait for the community to respond to this. I'd love to do some user interviews to understand this issue too.
Fully agreed, it is really important to be short, maybe the flags approach is a good solution, I think just one line will be added.
@OtacilioN the translations listing page does include a flag based on language/country
https://github.com/Roshanjossey/first-contributions/blob/master/Translations.md
How useful would it be to have them listed again in the main README when the
Read this in other languages. points you to the file I linked.
One enhancement that can be done is to list somewhere the total translations supported. Either on the main README or on the translations readme
@sara-02, @OtacilioN is suggesting flag emojis that links to corresponding translations.
Consider someone who can't understand the sentence Read this in other languages (because they can't understand English). They could benefit if they can understand flags.
Oh. Ok Yes, it makes sense now :)
In that case Flags and language names would be better, because for even for the same flag we can have multiple languages, like Indian flag can be used any regional Indian language.
Yes, but to not increase much lines in the README.md we could add just the flags in the README, and for countries that just have one language, such as Brasil, we can link directly, and for countries with multiple languages, such as India, we can link to a Readme called indiaLangs.md with a list containing all languages available for india
@OtacilioN That sounds good to me :)
Hi, everyone. What if we placed all the flags inside a single link on README.md that leads to Translations.md ? Thid way it wouldn't bloat the README.md and still allow the viewers to choose their specific dialect on Translate.md
Example:
Posted branch with what @umluizlima suggested
@umluizlima, if each flag is linked to corresponding tutorial, we reduce the number of clicks for user. We were trying to optimize that experience. For countries that has multiple languages, it could link to Translation.md like you suggested.
@GriffinAustin, I see your pull request to address this issue. Thank you for taking it up. Let's continue conversation there and take it forward.
As the before PR does not fit this discussion I submit another one with the implementation discussed here.
Closing this as this has been resolved in #5866
Most helpful comment
Closing this as this has been resolved in #5866