Doc improvements

doc/firststeps/login.rst

@@ -29,8 +29,8 @@ The administrator just logs in with his username.
 
 .. note:: You can configure privacyIDEA to authenticate administrators
    against privacyIDEA itself, so that administrators
-   need to login with a second factor. See SUPERUSER_REALM in
-   :ref:`inifile_superusers` how to do this.
+   need to login with a second factor. See
+   :ref:`faq_admins` how to do this.
 
 
 Login for normal users

doc/policies/index.rst

@@ -141,7 +141,7 @@ Each policy can contain the following attributes:
   The priority field of policies contains a positive number and defaults to 1.
   In case of policy conflicts, policies with a lower priority number take precedence.
 
-  It can be used to resolve policy conflicts. An example is the :ref:`passthru-policy`:
+  It can be used to resolve policy conflicts. An example is the :ref:`passthru_policy`:
   Assume there are two passthru policies ``pol1`` and ``pol2`` that
   define different action values, e.g. ``pol1`` defines ``passthru=userstore``
   and ``pol2`` defines ``passthru=radius1``.

privacyidea/lib/policy.py

@@ -869,8 +869,7 @@ def set_policy(name=None, scope=None, action=None, realm=None, resolver=None,
     If the policy with this name already exists, it updates the policy.
     It expects a dict of with the following keys:
     :param name: The name of the policy
-    :param scope: The scope of the policy. Something like "admin", "system",
-    "authentication"
+    :param scope: The scope of the policy. Something like "admin" or "authentication"
     :param action: A scope specific action or a comma separated list of actions
     :type active: basestring
     :param realm: A realm, for which this policy is valid