Document implementation details on the Javascript client

[plcp]

Few details have been given in answer of 5e29d15 and should be integrated with the documentation of the library – as GitHub comments are not a practical way of documenting the library in a long-term, resilient fashion.

This is especially interesting as most of the library have been designed to have all of its parts at least configurable and for the most part completely replaceable by a custom implementation of the appropriate handler – this will be useful only if people can hack into it with well-documented behaviors.

TL;DR: Giving more insights on the implementation details of the client will enable fellow power-users and researchers to hack their way through the code.