Update documentation

Author: humitos

docs/configuration.rst

@@ -153,16 +153,15 @@ These settings are global and have effect on both, tooltips and modal dialogues.
 .. _Mathjax: http://www.sphinx-doc.org/es/master/usage/extensions/math.html#module-sphinx.ext.mathjax
 
 
-.. warning::
-
-   You shouldn't modify the following three settings (api_host, project, version) unless you know what you are doing.
-   Their defaults should be fine to build the documentation and make it work in Read the Docs.
-
-
 .. confval:: hoverxref_api_host
 
    Description: Host URL for the API to retrieve the content of the floating window
 
+   .. warning::
+
+     You shouldn't modify this setting unless you know what you are doing.
+     Its default should be fine to build the documentation and make it work in Read the Docs.
+
    Default: ``https://readthedocs.org``
 
    Type: string

docs/development.rst

@@ -82,7 +82,7 @@ To make the extension to work, you will need to define this setting in your ``co
 
 .. code-block:: python
 
-   hoverxref_api_host = 'http://dev.readthedocs.io:8000'
+   hoverxref_api_host = 'http://community.dev.readthedocs.io'
 
 .. tip::
 

docs/usage.rst

@@ -7,7 +7,7 @@ and will embed the content of the document/section the link is pointing to, into
 
 ``: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 :ref:`Sphinx's ref role documentation <sphinx:ref-role>` for more information.
+See Sphinx's :rst:role:`ref` for more information.
 
 Simplest usage example,