English Language & Usage Asked on February 17, 2021
I work on a technical manual where each separate rule is followed by an example. (Actually, each rule is followed by two examples, a correct one and a wrong one. The wrong ones are skipped for brevity.) Here is a small excerpt from it:
Attributes
Put attributes below rather than above captions.
.Caption [columns="1, 2", grid="none"]
Put a space after a comma; do not put spaces around an equal sign.
[columns="1, 2", grid="none"]
It seems to me that "Put" in the beginning of the second sentence, due to the same word in the beginning of the first sentence, is somewhat ambiguous.
- Do we mean "Do not forgot to put a space after a comma"? (yes we do). Or
- do we mean "Put a space after rather than before a comma"? (no we don’t).
How to solve this issue? Is it better to replace the second "Put" with "Do put"? Or maybe it is better to replace the first "Put" with "Place"? Or maybe there is some another way?
My suggestion
Place attributes below rather than above captions.
Insert a space after a comma; do not put spaces around an equal sign.
Correct answer by chasly - supports Monica on February 17, 2021
Get help from others!
Recent Answers
Recent Questions
© 2024 TransWikia.com. All rights reserved. Sites we Love: PCI Database, UKBizDB, Menu Kuliner, Sharing RPP