Grammar

Estimated reading: 3 minutes 116 views

Capitalization by APA Style

Use Title Case capitalization for summarizing content:

This is in general first heading on a screen
Capitalize all words with more letters than 3

Use Sentence Case capitalization for everything else.

Here you can find all regulations: APA Style.

Front-loaded information

Users don’t read; they scan the interface for clues.

Start with the highest information value

That’s how users can identify the objective with an initial glance at the beginning.

Structure
1 – Objective:
2 – User action

You can usually tell the objective of the sentence by the article “to“ that introduces the clause.

Do

Remove a document from this tray by right-clicking on it and pressing “Delete”.

Don't

Right-click on a document and press “Delete” to remove it from this tray.

Do

To design your workflow, drag activities from the left into this area.

Don't

Drag activities from the left into this area to design your workflow.

Active voice

Users get the feeling of direct speech. Because of this active voice is more conversational and encouraging.

Write in an active voice

This makes a clear and short sentence structure.

Do

Update your DocuWare Desktop Apps.

Don't

The DocuWare Desktop Apps have to be updated by you.

Short text blocks

If you are unsure about your writing, use the Hemingway App to check your text.

Focus on a small number of key concepts

Divide long sentences into several sentences according to their key concepts

Do

A scheduled task will be created within the Windows Task Scheduler.
The credentials provided will be stored so that the scheduled task has access to the domain.

Don't

A scheduled task will be created within the Windows Task Scheduler, and the credentials provided will be stored so the scheduled task has access to the domain.

Use bullets and numbered lists for enumerations

Do

In the file cabinet configuration, you can do the following:

Select the file cabinet you want to use for Intelligent Indexing.
Define the store dialog to be used.
Define the mapping between the Intelligent Indexing categories and the DocuWare index fields.

Don't

You change into the file cabinet configuration. There you select the file cabinet you want to use for Intelligent Indexing, and you define the store dialog to be used and the mapping between the Intelligent Indexing categories and the DocuWare index fields.

Punctuation

Avoid exclamation and question marks

Avoid these characters. The text you’re writing should always be in a matter-of-factually way. Using those characters might bring to much enthusiasm to the text.

Use exclamation marks only to highlight content that should not be over-read by users.
Use only 1 exclamation/question mark per component.

DocuWare Design

Grammar

Capitalization by APA Style

Front-loaded information

Start with the highest information value

Do

Don't

Do

Don't

Active voice

Write in an active voice

Do

Don't

Short text blocks

Focus on a small number of key concepts

Do

Don't

Use bullets and numbered lists for enumerations

Do

Don't

Punctuation

Avoid exclamation and question marks

CONTENTS

Loading Patterns

Alerts

Banners

Bias-Free Language

Text

Text Area

Time Input

Date Input

Slot Input

Masked Input

Number Input

Text Input