See the attached diff for the gorey details!
Created attachment 80489 [details, diff] power-management-guide.diff
Thanks for the cleanup, looks good to me. Not sure about <e> vs. <b>, is there some kind of policy for that?
(In reply to comment #0) > See the attached diff for the gorey details! > Eh, I'm not liking this. It's not proper English to capitalize articles (a, an, the) and conjunctives (and, but). Also, the general title capitalization standard across the guides has been this: If it's a Chapter title, capitalize all the words (with the above exceptions). If it's just a Section title, then only the first word of the title is capitalized. 90% of the docs are done this way, at least! Still, you did do some significant work in creating this patch. Can you clean it up and resubmit for further evaluation? And/or explanations, etc. I'd be much obliged. :)
(In reply to comment #3) > (In reply to comment #0) Oh, and prepositions should never be capitalized. Forgot to mention that.
Well, let's say that: http://www.gentoo.org/doc/en/xml-guide.xml is considered the "policy" on writing docs. Then the actual rule would go: "Chapter and section titles should have just the first letter capitalized. The same rule applies to pre captions as well." If we want something different it should be noted in the policy so the docs are more consistant. Otherwise it seems a little odd to tell people "Do it this way before the patch gets commited". The same rule has applied to Gentoo development in general, and has worked out pretty well (save the flamewars ;). Once a decision is made I'll clean this up.
Any progress here?
Fixed in CVS. Thanks for the patch. If you want to modify it further, please reopen the bug.