Properly document all libraries

[ndmitchell]

Include what the library does, why you should use it, how you use it (small example)