Page MenuHomePhabricator

Define on a consistent naming pattern for all Check card titles
Open, Needs TriagePublic

Description

This task involves the work of defining a consistent naming pattern for all Check card titles for both Mid-edit and Pre-save moments.

The need for this task emerged as part of T390310 wherein @bmartinezcalvo helpfully noted that, as of 26 June 2025, Tone Check and Reference Check use different title conventions:

  • Tone Check: Revise Tone? - It asks the user if they want to do the action
  • Reference Check: Add a citation - It's a call to action)
  • Paste Check: Pasted content - It informs the user about an issue

Possible solutions

We could apply a consistent title approach in all checks and rely on the description to explain more about each check.

Op.1: Simple title
  • Tone
  • Citation
  • Pasted content
Op.2: Call to action in the title
  • Revise tone
  • Add a citation
  • Revise pasted content

Event Timeline

Per my comment in the doc, I don't know if this inconsistency isn't the least worst approach for now, at least until we get some broader community feedback about Tone Check.

My proposal is to be consistent with all check's titles since it's the most visible part of the check at first glance. In case we need to include a question as in the Tone Check (Revise tone?), we can rely on the card's description to do that, since the description is more secondary than the title.

Some options to apply a consistent title:

  • Op.1: Use the most simple title
    • Tone
    • Citation
    • Pasted content
  • Op.2: Use a call to action in the title to push users to complete the action
    • Revise tone
    • Add a citation
    • Revise pasted content
  • Op.2: Use a call to action in the title to push users to complete the action
    • Revise tone
    • Add a citation
    • Revise pasted content

+1 to this proposal. it would also align with how we capitalize suggested edits on the newcomer homepage.. which is sentence case [1]

CleanShot 2025-11-06 at 12.54.20.png (750×1,624 px, 244 KB)
Arc 2025-11-06 12.55.08.png (750×1,624 px, 216 KB)
Arc 2025-11-06 12.55.18.png (750×1,624 px, 228 KB)

[1]: https://en.wikipedia.org/wiki/Letter_case#Sentence_case