User interface text

How we talk to our users

www.drupaleurope.org

User interface text

How we talk to our users

Antje Lorch

ifrik

Site builder

biologist, scientific editor, political activist

Documentation WG, UX team

From documenting to fixing things

What are user interface texts?

for the developer

for the user

for the site builder, front end developer, translator, administrator, evaluator...

A default Drupal installation has more than 200 pages with UI texts.

UI texts are the words
that the developers speak
to the users.

Users don't see your functionality.
They see your words.

UI texts are important.

Therefore we have UI text standards. Not.

drupal.org/drupalorg/style-guide/content

https://www.drupal.org/docs/develop/user-interface-standards/interface-text

https:www.drupal.org/docs/develop/documenting-your-project/help-text-standards

All summaries must be less than 80 characters, start with a capital letter, and end with a period (.).
They must provide a brief description of what [the element] does.

Drupal API documentation standards
drupal.org/docs/develop/coding-standards/api-documentation-and-comment -standards

Reviewing with standards

All module descriptions must be less than 80 characters, start with a verb and a capital letter, and end with a period (.).

Together with the module name they must form a sentence that describes what the module does or what it allows the user to do.