Update guidance for writing short titles

[lsabor]

short titles are supposed to be more coherent now, the text when creating a question should be changed: This should be a shorter version of the Long Title, used where there is less space to display a title. It should end with a question mark. Examples: "NASA 2022 spacesuit contract winner?" or "EU GDP from 2025 to 2035?"

[lsabor]

@claude do this

[claude]

Claude finished @lsabor's task in 2m 54s —— View job

---

Task: Update guidance for writing short titles

• Explore repository structure to find the short title guidance text
• Identify all locations where the guidance needs updating
• Compare current text vs requested text

Finding

The text you requested is already present in the codebase. The English source string at front_end/messages/en.json:1094 reads:

"shortTitleExplanation": "This should be a shorter version of the Long Title, used where there is less space to display a title. It should end with a question mark. Examples: "NASA 2022 spacesuit contract winner?" or "EU GDP from 2025 to 2035?""

This is character-for-character identical to the wording you proposed in the issue body.

This key is used in the question creation form (front_end/src/app/(main)/questions/components/question_form.tsx:685) and the group form (front_end/src/app/(main)/questions/components/group_form.tsx:638).

Equivalent translations are already in place in:

• front_end/messages/cs.json:726
• front_end/messages/es.json:728
• front_end/messages/pt.json:814
• front_end/messages/zh.json:717
• front_end/messages/zh-TW.json:876

Next steps

It looks like this change was already applied. A couple of possibilities — let me know which (if any) applies and I'll do the work:

1. You meant a different wording — please share the exact before/after text you'd like.
2. You also want the notebook form to show this explanation — currently notebook_form.tsx:257 renders the short title InputContainer without an explanation prop, so no helper text appears there. I can add it if desired.
3. Nothing to do — close the issue.