English Language & Usage Asked on September 27, 2021
The following is from some software documentation we are writing:
NOTE: Refreshing a report may be necessary or helpful when:
- you believe the data in the report has changed since it was last executed
- you’d like to return the report to its initial state/condition
My question is this. Should ‘you’ in the first bullet item and ‘you’d’ in the second bullet item be capitalized?
It is a matter of style. Here are two options:
NOTE: Refreshing a report may be necessary or helpful when:
- You believe the data in the report has changed since it was last executed
- You'd like to return the report to its initial state/condition
NOTE: Refreshing a report may be necessary or helpful when:
- you believe the data in the report has changed since it was last executed;
- you'd like to return the report to its initial state/condition.
Create whatever rules you want for your software documentation and stick to them. As with all stylistic matters, consistency is key.
Correct answer by Jimi Oke on September 27, 2021
Bullet point items should be capitalised if the item in question is a full sentence. Likewise, in that case they should also have a full stop.
Answered by user3444 on September 27, 2021
My opinion is that there are two possible cases.
For example, under case one, I might list
In this case, I am interjecting bullets into my sentence, but the sentence should remain readable. This becomes more useful with complex lists, which may refer to
red,
green, or
yellow,
In this case, the above list is in fact a grammatical sentence, but the bulleting makes it easier to read, and as such the capitalization should maintain it's regular sentence-based form.
However, if I want to do something graphical in a document, or for a presentation, I say anything goes which effectively communicates. I might do this:
Answered by Brandon Hastings on September 27, 2021
Get help from others!
Recent Questions
Recent Answers
© 2024 TransWikia.com. All rights reserved. Sites we Love: PCI Database, UKBizDB, Menu Kuliner, Sharing RPP