review: add write-up about record-of-functions API

I think (but we have to try, we might realise is not the case) we
could make the library a bit more modular if we switch to a
records-of-functions API, which would allow for better encapsulation and
information hiding.