Introduction Writing Guidelines Colors & Icons Javascript Forms Grid Blankslate Avatars Buttons Alerts Modals Tooltips Panels Popovers Tables Navigation Utilities & Markdown Miscellaneous

# Writing

The user experience greatly depends on clear, concise, and consistent texts. We follow a set of guidelines concerning writing style and terminology to address this concern.

## Terminology

It is easier for the user to learn a concept once and associate it with one word. Thus we agree on some key terms and use them consistently across interfaces.

##### Author

Do not use “user”.

##### Book

Only use ‘book’ to name the intellectual entity of a book, not its representations. A book is defined by its title, author, and content (source). We avoid using ‘book’ to talk about outputted forms like e-books or websites of books, where we prefer using non-ambiguous, dedicated terms.

##### Discussion

Do not use “issue”.

##### Editor

With a capital ‘E’, to talk about the GitBook Editor (web or desktop).

Do not use “editor”.

##### Merge Request

Do not use “pull request”.

##### Update

Do not use “build”.