Clean up some outdated translation pages#3739
Merged
HiDeoo merged 2 commits intowithastro:mainfrom Mar 6, 2026
Merged
Conversation
✅ Deploy Preview for astro-starlight ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
Contributor
Lunaria Status Overview🌕 This pull request will trigger status changes. Learn moreBy default, every PR changing files present in the Lunaria configuration's You can change this by adding one of the keywords present in the Tracked Files
Warnings reference
|
delucis
approved these changes
Mar 5, 2026
Member
delucis
left a comment
There was a problem hiding this comment.
Thanks for cleaning this up @HiDeoo! I think this makes sense as a beginning.
We can also consider deleting some of these languages entirely if we want given we won’t have much beyond the basic landing page + 404. But this is a good start and we can discuss that in a follow-up PR.
sarah11918
approved these changes
Mar 5, 2026
Member
sarah11918
left a comment
There was a problem hiding this comment.
I think this is helpful! Outdated pages are not better than no pages at all. thank you Hideoo!
ArmandPhilippot
approved these changes
Mar 5, 2026
Member
ArmandPhilippot
left a comment
There was a problem hiding this comment.
Didn't spotted any French files in there, so LGTM! 😄 Some cleaning makes sense!
HiDeoo
added a commit
to HiDeoo/starlight
that referenced
this pull request
Mar 9, 2026
* main: [ci] release (withastro#3727) Clean up some outdated translation pages (withastro#3739) i18n(fr): update `resources/themes.mdx` (withastro#3741)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This PR removes some outdated translation pages from the Starlight documentation.
The goal is not to remove any languages that the documentation is currently translated into, but instead identify, discuss, cherry-pick, and remove any translations that may be outdated and also potentially harmful to users.
This PR starts by focusing on languages that have not been updated in the past year. For such languages, various factors have been considered to identify potentially misleading translations, such as:
Considering the above criteria, it seems that our guides and reference pages are the most likely to be inaccurate if they are outdated, e.g. by showing invalid examples, outdated syntax or options, etc. Some other pages, while outdated, may not be as much of a problem, for example:
Based on the above, I've identified the following languages as potentially having outdated and harmful translations, and thus I have removed such translation pages in this PR:
dahiiditpt-brpt-pttrThis PR is meant to be a starting point for discussion, so if you are using one of the above languages, or have contributed to some of the translations, please feel free to share your thoughts and feedback on this PR, and we can discuss it further.
I'd also like to note that if at any future point, anyone is motivated and would like to translate in the long run some of the deleted pages, they would be more than welcome to do so, and these deleted pages would still be available in the git history, so they can be easily used as a base for new translations (even though sometimes it may be easier to just start from scratch considering the amount of changes).