Document custom controls

As discussed on the list https://groups.google.com/d/msg/ol3-dev/LnN3IUNxtoM/K0glKxDU8nUJ
My bad; zIndex are not handled.