From 46c7bddff9a82cb39993291274a4567f306d24f3 Mon Sep 17 00:00:00 2001 From: Anna Larch Date: Tue, 22 Sep 2026 15:32:42 +0200 Subject: [PATCH 1/2] docs(translations): fix garbled sentences in the context-hints intro The opening of 'Provide context hints for translators' had three defects: a sentence fragment with no main clause, a duplicated 'which can which can be', and 'translations strings'. The closing line also ended in a colon that introduced nothing, since the block that follows is a warning rather than the promised example. Assisted-by: ClaudeCode:claude-opus-5 Signed-off-by: Anna Larch --- developer_manual/basics/translations.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/developer_manual/basics/translations.rst b/developer_manual/basics/translations.rst index fa651199a16..a6c55386ae3 100644 --- a/developer_manual/basics/translations.rst +++ b/developer_manual/basics/translations.rst @@ -304,10 +304,11 @@ This allows translators to have the cloudlink before the browselink in case the Provide context hints for translators ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -In case some translation strings may be translated wrongly because they have multiple meanings. -Especially translations strings that only contain a single word often result in problems. -The most famous example in the Nextcloud code base is ``Share`` which can which can be the verb and action ``To share something`` or the noun ``A share``. -The added hints will be shown in the Transifex web-interface: +Some translation strings can be translated wrongly because they have multiple meanings. +Strings that contain only a single word are especially prone to this. +The most famous example in the Nextcloud code base is ``Share``, which can be the verb and action +``To share something`` or the noun ``A share``. +Adding a context hint resolves the ambiguity, and the hint is shown to translators in the Transifex web interface. .. warning:: From b65935e2bb97bb090ca03a4f21785909cad7217d Mon Sep 17 00:00:00 2001 From: Anna Larch Date: Tue, 22 Sep 2026 15:32:52 +0200 Subject: [PATCH 2/2] docs(translations): document contributing a context hint without a checkout Context hints are one of the few code changes worth making without a development environment, and translators are usually the people who notice that a string is ambiguous. The page explained what a TRANSLATORS comment looks like but assumed a local checkout, so there was nothing to point a translator at. Adds a section covering the GitHub web-editor route: the fork wall and what a fork is, that forking happens once and a stale fork needs syncing first, the commit dialog, the conventional-commit message and why a pre-filled suggestion usually needs a type prefix, the automatic DCO sign-off, avoiding lint failures that cannot be fixed from the web interface, who reviews and that outside contributors cannot add labels or assignees, where to tell the translation community, and that a merged hint only reaches Transifex at the next string sync. Four screenshots cover the steps where a newcomer is most likely to stop. Also states which languages actually require the TRANSLATORS prefix. The examples silently switched convention, which made the Qt and iOS ones read as omissions: they use their own markers, and TRANSLATORS there produces no hint at all. Assisted-by: ClaudeCode:claude-opus-5 Signed-off-by: Anna Larch --- developer_manual/basics/translations.rst | 143 ++++++++++++++++++ .../translations-hint-editor-fork-banner.png | Bin 0 -> 105904 bytes .../translations-hint-fork-required.png | Bin 0 -> 101668 bytes .../translations-hint-signoff-dialog.png | Bin 0 -> 195290 bytes .../images/translations-hint-sync-fork.png | Bin 0 -> 44507 bytes 5 files changed, 143 insertions(+) create mode 100644 developer_manual/images/translations-hint-editor-fork-banner.png create mode 100644 developer_manual/images/translations-hint-fork-required.png create mode 100644 developer_manual/images/translations-hint-signoff-dialog.png create mode 100644 developer_manual/images/translations-hint-sync-fork.png diff --git a/developer_manual/basics/translations.rst b/developer_manual/basics/translations.rst index a6c55386ae3..fd939781895 100644 --- a/developer_manual/basics/translations.rst +++ b/developer_manual/basics/translations.rst @@ -377,6 +377,16 @@ In the ``