-
-
Notifications
You must be signed in to change notification settings - Fork 28.1k
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
Adding non-English resources to a themed list? #1282
Comments
I don't think it makes sense to mix languages in the main readme. That just creates a messy experience for everyone. Instead, make the main readme.md have only English content, then at the top of that readme, add links to other languages which can be in their own Markdown files. For example:
When we've decided on a good format, we should document it here. |
The idea on below format makes sense for translating into multiple languages. But what we want to is to bring articles written natively by other languages instead of translation.
|
@zhaoyi0113 That's what I'm talking about too. |
I feel that the different README files structure would be interesting if there would be a lot of resources in the different languages. But most of the time that's just not the case. There's maybe 95% of the resources available in English, since English is still prominent in computer sciences, and 5% of very specific stuff not already covered by the 95% and written in some other other language. In the age of evolved translators like DeepL, I don't see any reason to not add an article written in another language if it really adds to the list. Non-English articles could be enforced to have at least one translation, with a guideline on how to format translations. For example, something in those lines would make sense to me:
I think such a format would also be very useful for local lists, non related to computer science, where the main language might be something else than English and with resources in different languages. What do you think @sindresorhus? |
I have yet to see a technical paper in Chinese being readable after running it through Google Translate, but I don't see why not if it's still good after being translated.
Since the list is in English, the main link should point to the translated version. The original can be linked to in parens, like (Source). |
Yep, and it has the advantage of forcing a proper translation in the list's main language as the main link. I definitely support that solution. |
Well that's the problem with other languages there is just not that much stuff into them |
Duplicate of #1664 |
Please see this issue on Awesome MongoDB: ramnes/awesome-mongodb#43
By reading #153 and #1176, I seem to understand that all the non-English resources are supposed to go in separated lists, rather than being regrouped under the main theme list, even if they're not translations but really add to the list.
Can't we do better and be more inclusive to non-English speakers? For example, by adding a country flag in front of all resources, indicating the language of the resource?
The text was updated successfully, but these errors were encountered: