Split developer localization info out of the translator page#543
Split developer localization info out of the translator page#543
Conversation
✅ Deploy Preview for openrefine-website ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
…e-to-localization.md Co-authored-by: tfmorris <82178+tfmorris@users.noreply.github.com>
magdmartin
left a comment
There was a problem hiding this comment.
This is an interesting use case for @copilot. As a project, do we want to rely more on AI-assisted tools to manage our documentation? If so, we may want to define some boundaries. For example, limiting AI-generated contributions to experienced contributors (e.g., committers) could help reduce low-quality or poorly reviewed output and avoid unnecessarily increasing reviewer workload.
| [Run OpenRefine from the master branch](/docs/technical-reference/build-test-run) and check whether translated words fit to the layout. Not all items can be translated word by word, especially into non-Ìndo-European languages. | ||
|
|
||
| So the key `core-index/help` will render as `"Aide"` in French. | ||
| If you see any text which remains in English even when you have checked all items, please create a bug report in the issue tracker so that the developers can fix it. Similarly report any cases where the developers have used string concatenation or layout to compose multi-part strings, rather than using the localization facilities. |
There was a problem hiding this comment.
Should we recommend to open the bug on the main Github bug tracker (https://github.com/OpenRefine/OpenRefine/issues/new?template=bug_report.md ) and then the team triage the right repo? This would be the case if the missing translation is on an extension.
translating-ui.mdmixed translator guidance with developer implementation details. The translator page should focus solely on Weblate usage and translation workflow.Changes
translating-ui.md— stripped to translator-relevant content only:developer-guide-to-localization.md(new) — developer-focused localization reference:lang-settings-ui.htmlregistration.propertiesfiles and Java class generationsidebars.js— addsdeveloper-guide-to-localizationto the "Contributing as a developer" sidebar section.Original prompt
💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.