Max depth: 2 and link to usage from home's Tip

Author: humitos

docs/index.rst

@@ -31,10 +31,13 @@ This will :hoverxref:`show a tooltip <hoverxref:hoverxref>` in the linked words.
 .. tip::
 
    This new ``hoverxref`` role is an alias of the ``ref`` role and works in the same.
+   See :ref:`usage:usage` for more detailed information about and other examples.
 
 
+----
+
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
    :caption: Contents
 
    installation
@@ -44,7 +47,7 @@ This will :hoverxref:`show a tooltip <hoverxref:hoverxref>` in the linked words.
 
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
    :caption: API Reference
 
    autoapi/hoverxref/index

docs/usage.rst

@@ -5,7 +5,7 @@ This extension defines a custom role called ``:hoverxref:``.
 When this role is used, it will show a tooltip when the ``hover`` mouse event is triggered,
 and will embed the content of the document/section the link is pointing to, into the tooltip's content.
 
-``:hoverxref:`` uses Sphinx's internals reference resolution to find out where the link points to.
+``:hoverxref:`` role uses Sphinx's internals reference resolution to find out where the link points to.
 So, the way of referencing the section works in the same way as the ``:ref:`` standard role.
 See `Sphinx's ref role documentation`_ for more information.