ticket:10640: Improve documentation.

git-svn-id: http://source.icu-project.org/repos/icu/icu@35147 251d0590-4201-4cf1-90de-194747b24ca1