FrancescoCastaldi commented on PR #43274: URL: https://github.com/apache/superset/pull/43274#issuecomment-5465120592
@sfirke Thanks for reviewing! The `#. do-not-translate` header is an **extracted comment** (`#.`) that propagates from `superset/translations/messages.pot` into all language catalogs during `pybabel update`. Its main purposes are: 1. **Guidance for literal code tokens / identifiers**: It tags strings that were extracted by Babel because they appear inside `t(...)` / `_()` calls, but represent technical constants, icon names (such as `bolt`, `step-after`), enum keys (`TEMPORAL_RANGE`, `DELETE`, `OVERWRITE`), SQL syntax keywords (`GROUP BY`), percentiles (`p95`, `p99`), or mock/example domains (`superset.example.com`). 2. **Automation filter**: Scripts like `scripts/translations/backfill_po.py` inspect the `#. do-not-translate` tag to skip machine-translating these tokens, preventing automated batches from altering programmatic tokens. 3. **Translator context**: It informs maintainers and translators that the string is a literal token, so they can keep it literal or understand the technical context. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
