Usage.xml

Word Choice

Since vs. Because

Use of contractions

Web services, not webservices.

Changelogs, not change logs.

Structural Considerations

Parallelism

Having a parallel structure ensures that elements of a sentence or other document component that are similar in purpose are similar in structure. Parallel structure helps to emphasize the similarities of elements and improves readability by making the content more predictable.

See Parallelism

Table Formatting

Document Voicing

Present tense

Use of second person.

Use of second person is preferred as it provides a friendly tone and interacts with the user. It also helps to avoid passive voice.

Avoid passive voice.