more documentation about this library

@waywardmonkeys mind merging this one?