Create class and method doc-strings, and elaborate itorated variable names

[caseymacphee]

Hi Tom, I found your library recently and really liked it. I did some documentation and wrote out some variables names to make it more readable when I show it to my team. I thought maybe you and others may appreciate it. Cheers

Casey