The 'Voice' section of the Online documentation style guide contains the paragraph...

"Humanize buttons: "Submit" and "Click here" are not as clear or personable as "Sign me up," "Join now," "Please enroll me," etc."

This represents a style recommendation for coders rather than online documentation, as the documentation needs to match what the code actually does, and so such a change would need to be made in the code rather than in the documentation.

This entry should be moved to the appropriate section of our coding standards writing style guide for user messages and related UI elements. I'm not sure where exactly that would be. If that section doesn't already exist, it should be created.

Comments

jjkd’s picture

jjkd commented

Ok, looks like this should move to somewhere downstream from Drupal UI guidelines.

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Project: Drupal core » Documentation
Version: 7.x-dev »
Component: documentation » Correction/Clarification
Status: Active » Fixed

Thanks! I've removed that section - you are right it doesn't belong. And it doesn't fit with our UI text guidelines anyway, which are at http://drupal.org/node/501452 and http://drupal.org/node/60434

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.