Skip to content

Improve entry for sentence length #601

@daobrien

Description

@daobrien

https://stylepedia.net/style/6.2/#sentence-structure

This includes an example of poor writing (a very long sentence) but not example of how to improve it.

Sentence Length
Try not to pack too much information into one sentence. In technical documentation, try not to exceed 40 words in a sentence. Keep it short. The following sentence is a bad writing example:
The Start button, which you can find in the bottom left corner of your screen (also activated by the "Windows key" on your keyboard, the one between the Ctrl and Alt keys), provides a central starting point for applications and tasks, and can be customized according to your individual preferences so that it presents menu items relevant to you instead of presenting the standard items that come with the default installation of the operating system, items which, in my opinion, are irrelevant for most users these days who really only need access to an internet browser such as Google Chrome or Mozilla Firefox.

Metadata

Metadata

Assignees

Labels

impedimentNot really a bug but annoying.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions