Translation System Proposal #209
Conversation
Adding QA guide to improve asking questions inclusively
DISCOVER/_QA_Protocols.md
Outdated
There was a problem hiding this comment.
Please move to another PR. We are still in the process of deciding how to include more content in the repo.
There was a problem hiding this comment.
Please rename to 001-Translations.md
| Translation Project for Discover-Cookbook | ||
|
|
||
| ## Abstract | ||
| The discover-cookbook is a valuable resource for culinary enthusiasts. Translating the content will make it accessible to a broader audience, fostering a global community of users. The project involves generating translations for the discover-cookbook, integrating language selection switches, updating translations as content changes, and engaging translators to contribute. |
There was a problem hiding this comment.
Why the comment about culinary enthusiast? Seems out of place.
Also need to captialize the acronym, DISCOVER Cookbook.
There was a problem hiding this comment.
My apologies, it's a typo, I was writing compassionate.
I'll keep that in mind.
| **What We Are Doing:** Translating the entire content of the discover-cookbook into multiple languages. | ||
|
|
||
| **Technical Approach:** | ||
| - Evaluate and select a reliable translation tool or service (e.g., Google Translate, Microsoft Translator). |
There was a problem hiding this comment.
Hmm, is there a better way than just running the content through an AI translation tool? There is a lot of nuance to this guide and we need to have readers who will catch that. I was thinking more of working with translation communities that could provide the translation and feedback, e.g. https://translatewiki.net/
We could also incorporate our own service like: https://pootle.translatehouse.org/
But if we are just going to be piping to Goolge Translate, I don't see much value over the people doing that themselves.
There was a problem hiding this comment.
For some more context on why AI translations are not sufficient, see for example this blog post I wrote when we were starting on the translation effort for scientific python websites: https://blog.scientific-python.org/scientific-python/translations/
There was a problem hiding this comment.
Hmm, is there a better way than just running the content through an AI translation tool? There is a lot of nuance to this guide and we need to have readers who will catch that. I was thinking more of working with translation communities that could provide the translation and feedback, e.g. https://translatewiki.net/
We could also incorporate our own service like: https://pootle.translatehouse.org/
But if we are just going to be piping to Goolge Translate, I don't see much value over the people doing that themselves.
Sounds right, I actually didn't knew about the community who could provide translations. It would be better if we use the translation community, as it stands out and people will engage
|
Updated title to be more accurate. @speco29 have you had any more time to update the proposal? Would like to get something accepted that we can iterate on in the discussion. |
I have this thought that for switches/toggles for language change, I can simply use HTML, CSS, JavaScript. |
|
The issue with just adding HTML/CSS/JS is that it will need to be integrated with the jupyter book system. While doing something custom is probably easier, it would be harder to maintain. |
Made a proposal for the projeect DISCOVER-Cookbook to plan the translation of the cookbook.