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

Docs: Add suport for multiple languages #64

Open
arejula27 opened this issue Jul 26, 2024 · 2 comments
Open

Docs: Add suport for multiple languages #64

arejula27 opened this issue Jul 26, 2024 · 2 comments
Labels
priority: low Might be supported or done in the future, but won't be prioritised state: pending Pending requirements, dependencies, data, or more information.

Comments

@arejula27
Copy link

Add support for multiple languages. The idea should be to provide a way to let people contribute to the translation of the webpage

@xynydev
Copy link
Member

xynydev commented Jul 26, 2024

Starlight has built-in support for internationalization, which would make this pretty straightforward to implement for the main documenation pages: https://starlight.astro.build/guides/i18n/
Adopting translation for module reference pages would be slightly more complicated, but probably possible eventually.

However, my main concern is the maintenance prospects of multi-language documentation. I am not committed to maintaining and reviewing translations of the documentation. A trusted maintainer proficient in said language would be needed for every language variant to effectively review the translations and keep them up-to-date. I'd rather have English-only documentation than outdated and possibly misleading documentation in other languages. Having the translated documentation be part-English to remedy the incompleteness of translations is a possible band-aid solution, I guess.

If you (or anyone) is interested in contributing and maintaining translations of some of the more static key documentation pages as a pilot, I wouldn't be opposed to that. And of course in the future when / if the project grows and stabilizes, internationalized documentation will become a more feasible and desirable thing to do.

@arejula27
Copy link
Author

Let's wait then

@xynydev xynydev added state: pending Pending requirements, dependencies, data, or more information. priority: low Might be supported or done in the future, but won't be prioritised labels Dec 6, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
priority: low Might be supported or done in the future, but won't be prioritised state: pending Pending requirements, dependencies, data, or more information.
Projects
None yet
Development

No branches or pull requests

2 participants