Skip to content

Review Polish user guide and localize shortcut ranges - #572

Merged
pedro-hdias merged 1 commit into
gabrielhhaber:mainfrom
djgraco:polish-translation
Oct 21, 2026
Merged

pedro-hdias merged 1 commit into
gabrielhhaber:mainfrom
djgraco:polish-translation

Conversation

@djgraco

@djgraco djgraco commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

This PR updates the Polish user guide following a native-speaker review. Several passages used older interface terminology, documented incorrect shortcuts or settings paths, or described behaviour too ambiguously. The changes make the instructions easier to follow, including when reading them with a screen reader.

The review covers:

  • Interface terminology: chat categories, forwarding, last-seen information, chat access protection and the local vault.
  • Default shortcuts and settings paths, including incoming-call actions and the Polish Messages menu.
  • Explanations of local transcription, online AI processing, model selection, memory use and audio devices.
  • Instructions for F5 resynchronization, backups, drafts and media cleanup, clarifying what each operation affects.
  • More natural Polish wording and consistent use of “podręcznik” for the user guide.

The shortcut-table generator previously used the Portuguese range separator “a” in Polish output, producing ranges such as “Ctrl+Alt+1 a 9”. This PR adds a locale-specific range format so Polish uses “Ctrl+Alt+1 do 9”. Other locales retain their existing output. Four regression tests cover range formatting and grouping.

The Polish PO changes the Media tab label from “Multimedia” to “Media” to match the reviewed terminology. Its revision and template-reference dates are also updated. The four recently added business-button translations and the corresponding new guide content are preserved.

The shipped Polish HTML guide has been regenerated from the updated sources and catalog.

Validation completed locally on Windows:

  • msgfmt --check --check-format: passed.
  • uv run translations-check: passed for all seven locales, with zero pending entries.
  • Polish guide generation: passed.
  • uv run pytest tests/test_user_guide_shortcut_ranges.py tests/test_user_guide_coverage.py: 7 passed.
  • git diff --cached --check: passed.

@pedro-hdias pedro-hdias left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello, @djgraco! Thank you for this contribution! It was approved without further comments. We appreciate it! See you soon!

@pedro-hdias
pedro-hdias merged commit 25c2368 into gabrielhhaber:main Oct 21, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants