Nicely written *but* of course best documentation for your lib is good API that is easy to understand and straightforward to use ;)