Word choice

Overview

Talking with users and writing developer documentation are different.

With users, use common words whenever possible. Write like you speak. Consider simple everyday words first.

With developers, formal and written language, and even technical terms usually take higher precedence.

A few interesting cases (in alphabetical order):

UserDev
Keyboard shortcutKey binding
Link to headingSlug; Anchor ID
Math blockDisplay math
SettingsConfiguration

References