Rule Source
This rule comes from: https://github.com/mesosphere/dcos-docs-site
Rule Definition
extends: existence
message: "Don't start a sentence with '%s'."
level: error
raw:
- '(?:[;-]\s)so[\s,]|\bSo[\s,]'
This rule prevents writers from starting sentences with the word "So," a common but informal writing habit that can weaken professional documentation. Starting sentences with "So" is often a conversational tic that has crept into written communication, making the text feel less authoritative and more casual. While this construction might be appropriate in dialogue or informal writing, it's generally best avoided in technical or professional documentation.
✗ Incorrect:
✓ Correct:
The rule will flag any sentence that begins with "So" or follows certain punctuation (semicolons or hyphens) with "so", regardless of whether it's followed by a comma or space.
This rule comes from: https://github.com/mesosphere/dcos-docs-site
extends: existence
message: "Don't start a sentence with '%s'."
level: error
raw:
- '(?:[;-]\s)so[\s,]|\bSo[\s,]'