Users guide, including best-practices notes (from my point of view).  Not everyone agrees with me on all the details, so feel free to raise issues/add your own ideas, etc.  If we have conflicting ideas, that's probably OK as long as the pros/cons are presented along with differing opinions.
Users guide, including best-practices notes (from my point of view).  Not everyone agrees
with me on all the details, so feel free to raise issues/add your own ideas, etc.  If we have
conflicting ideas, that's probably OK as long as the pros/cons are presented along with
differing opinions.


git-svn-id: 6ecf90c357d929aee58b51a998def805f2e9c62f@138898 13f79535-47bb-0310-9956-ffa450edef68

apache/commons-logging,apache/commons-logging,mohanaraosv/commons-logging,apache/commons-logging,mohanaraosv/commons-logging,mohanaraosv/commons-logging