If you write or rewrite docs, it might be interesting to quickly read
the language guidelines of the JBoss documentation guide, chapter 7:
http://hudson.jboss.org/hudson/job/JBoss_Documentation_Guide/lastSuccessf...
It contains stuff like "use active voice", "avoid future tense", ...
and it's not that long (that chapter at least :)
--
With kind regards,
Geoffrey De Smet