Document custom controls

As discussed on the list https://groups.google.com/d/msg/ol3-dev/LnN3IUNxtoM/K0glKxDU8nUJ
I don't think the lib applies any zIndex'ing to controls.