diff --git a/doc/source/REST.rst b/doc/source/REST.rst
index 2eb6de082..5befefef4 100644
--- a/doc/source/REST.rst
+++ b/doc/source/REST.rst
@@ -161,8 +161,8 @@ GET ``http://imserver.com/infrastructures/<infId>/<property_name>``
                  (the virtual infrastructure will not be modified).
       :``state``: a JSON object with two elements:
       
-         :``state``: a string with the aggregated state of the infrastructure (see list of valid states in :IM-States_).
-         :``vm_states``: a dict indexed with the VM ID and the value the VM state (see list of valid states in :IM-States_).
+         :``state``: a string with the aggregated state of the infrastructure (see list of valid states in :ref:`IM-States`).
+         :``vm_states``: a dict indexed with the VM ID and the value the VM state (see list of valid states in :ref:`IM-States`).
 
    The result is JSON format has the following format::
    
diff --git a/doc/source/xmlrpc.rst b/doc/source/xmlrpc.rst
index c6fa6d755..27dc5bb47 100644
--- a/doc/source/xmlrpc.rst
+++ b/doc/source/xmlrpc.rst
@@ -14,6 +14,9 @@ structs.
 
 .. _IM-States:
 
+IM valid States
+----------------
+
 List of valid VM and infrastructure states:
 
    The ``state`` can be
@@ -43,6 +46,9 @@ List of valid VM and infrastructure states:
       "stopped" -> "pending";
       "configured" -> "deleting";
 
+Methods
+-------
+
 This is the list of method names:
 
 ``GetInfrastructureList``