Page MenuHomePhabricator

Add qqq hints as guidelines to translate examples, too
Closed, ResolvedPublic

Description

As requested on Help talk:Extension:AdvancedSearch, there should be guidelines whether the examples in the help popups are supposed to be translated or not. Ideally, these guidelines would be shown directly in TranslateWiki.

What is requested is to update qqq.json explanations for the keys that are pointed out. The messages of these keys contain examples of how to use the Search syntax. We want to point out the parts of the en.json message that SHOULD be translated (example input text ), vs not translated (syntax and keywords).

Therefore, the qqq hints need to be extended. These are the new qqq hints with the added info:

"advancedsearch-help-plain": "Help text shown in a dialog for the field for plain search. Section \"Syntax-equivalent in the normal search\": Please also translate <code>sesame street car</code>.",
"advancedsearch-help-phrase": "Help text shown in a dialog for the field for exact search. Section \"Syntax-equivalent in the normal search\": Please also translate <code>\"Begin at the beginning\"</code>.",
"advancedsearch-help-or": "Help text shown in a dialog for the field for or search. Section \"Syntax-equivalent in the normal search\": Please also translate <code>Laptop</code> and <code>Notebook</code>, but not OR.",
"advancedsearch-help-not": "Help text shown in a dialog for the field for excluded words in search. Section \"Syntax-equivalent in the normal search\": Please also translate <code>-elephant</code> and keep the <code>-</code>.",
"advancedsearch-help-intitle": "Help text shown in a dialog for the field for searching pages with titles that start with this word. Section \"Syntax-equivalent in the normal search\": Please also translate <code>queen</code>, but not <code>intitle:</code>.",
"advancedsearch-help-hastemplate": "Help text shown in a dialog for the field for searching pages with a template. Section \"Syntax-equivalent in the normal search\": Please also translate <code>missing information</code>.",

Plus this one, which is not in the popup, but in the search fields themselves:

"advancedSearch-placeholder-commas": "Placeholder text shown in fields that accept multiple values separated by commas. Please also translate \"cats\" and \"goats\".",

Before changing these hints, please check if there are any syntax/formatting issues. This is because I added the text snippets, but I'm not familiar with the particular markup used here, so there might be a crucial character missing somewhere.

Thanks!
Johanna

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript
TheDJ triaged this task as Low priority.Jan 9 2026, 9:37 AM
TheDJ updated the task description. (Show Details)
TheDJ added a subscriber: Hqrshguptq.

Hi, I’m Tanvi, a new contributor and I’d like to work on this task.
I plan to update the relevant qqq.json entries to clarify which example text should be translated versus which search syntax should remain unchanged, as discussed on the help talk page. Do let me know if that's alright before I submit a patch.
Thanks!

Hi @TanviReddy30, please do go ahead, you are more than welcome to improve these messages.

There are instructions on how to submit patches at https://www.mediawiki.org/wiki/Gerrit/Tutorial/tl;dr
There are some guidelines for documentation mentioned here: https://www.mediawiki.org/wiki/Help:System_message#Message_documentation

I will review and/or merge your changes when you are ready.

Hey @TheDJ, I’ve submitted a patch to Gerrit extending the qqq.json hints as discussed.
Gerrit change: https://gerrit.wikimedia.org/r/c/mediawiki/extensions/AdvancedSearch/+/1227847

Change #1227847 had a related patch set uploaded (by Aklapper; author: Tanvi Reddy):

[mediawiki/extensions/AdvancedSearch@master] Clarify translation guidance for AdvancedSearch help examples

https://gerrit.wikimedia.org/r/1227847

Change #1227847 had a related patch set uploaded (by TheDJ; author: Tanvi Reddy):

[mediawiki/extensions/AdvancedSearch@master] Clarify translation guidance for AdvancedSearch help examples

https://gerrit.wikimedia.org/r/1227847

Change #1227847 had a related patch set uploaded (by TheDJ; author: Tanvi Reddy):

[mediawiki/extensions/AdvancedSearch@master] Clarify translation guidance for AdvancedSearch help examples

https://gerrit.wikimedia.org/r/1227847

Change #1227847 merged by jenkins-bot:

[mediawiki/extensions/AdvancedSearch@master] Clarify translation guidance for AdvancedSearch help examples

https://gerrit.wikimedia.org/r/1227847