One thing that I would love to have would be a piece of text explicitly describing the conventions, and if possible also justifying them or describing why they were chosen. I think that that would be very very useful in helping to understand the library.