-
Sub-task
-
Resolution: Obsolete
-
Minor
-
EAP_EWP 5.1.2
-
Documentation (Ref Guide, User Guide, etc.)
-
Not Required
-
ASSIGNED
General:
--------
Load balancing and load-balancing are not interchangeable. Load balancing is the act of balancing load. A server that balances load, or has its load balanced, however, is a load-balancing server.
You may want to make the move to sentence case for titles, purely because so many JBoss products are randomly lower-case that if you attach them to an upper-case verb it just looks bizarre. The other way around is not as jarring.
Also, try not to use a Procedure title immediately after a section title... it looks strange to go straight from large to small font without any intervening explanation.
Not all replaceable values are marked up as such, which can confuse readers as to what should be entered literally, and what should be replaced with their own values. They're usually named well to avoid this confusion, but in the event that people actually read our style details, they will be confused.
Decide whether you are using "the file _____" or "the _____ file". It flip-flops throughout the document.
Be consistent about using punctuation at the end of list items, and at the end of step titles.
Avoid using e.g. and i.e. – use for example and in effect instead.