SAK-23353 cleaned up code, improved documentation

git-svn-id: https://source.sakaiproject.org/svn/announcement/trunk@122047 66ffb92e-73f9-0310-93c1-f5514f145a0a