Take the 2-minute tour ×
English Language & Usage Stack Exchange is a question and answer site for linguists, etymologists, and serious English language enthusiasts. It's 100% free, no registration required.

The following is from some software documentation we are writing:

NOTE: Refreshing a report may be necessary or helpful when:

  1. you believe the data in the report has changed since it was last executed
  2. 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?

share|improve this question
add comment

2 Answers 2

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.

share|improve this answer
1  
I agree, but citation needed. –  Dan Dascalescu Apr 24 '13 at 9:06
add comment

It is a matter of style. Here are two options:


NOTE: Refreshing a report may be necessary or helpful when:

  1. You believe the data in the report has changed since it was last executed
  2. You'd like to return the report to its initial state/condition

NOTE: Refreshing a report may be necessary or helpful when:

  1. you believe the data in the report has changed since it was last executed;
  2. 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.

share|improve this answer
2  
Do you think the second style above comply with Wikipedia's Manual of Style, i.e. "when the elements are complete sentences, they are formatted using sentence case and a final period.", on this? Specifically, would it be better -- or not -- to have 1. You ... and 2. You'd ...? –  Computist Jul 15 '11 at 21:40
add comment

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.