Link to relevent parts of the documentation

Change-Id: Ib7c4ecbaa7481d30fcda4ba06939548f5ae243da
Clarify the documentation

Change-Id: If9b2899317e8fee85288e0f20f76132ef83256f3
Be consistent with calling the adders/removers methods and not accessors

The docs call them methods, now so does the code.

Change-Id: Idbcd098a6e8283ca45845d445f49f30f1e726e79