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:
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?