Hoverables documentation

I clarified the documentation for ``hoverables`` and also fixed a typo in the documentation for ``hoverable``.