DOC: Fixed misleading permission documentation (#193).

CHANGELOG.md

@@ -24,6 +24,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Documentation ###
 
 - Nested queries.
+- Global entity permissions.
 
 ## [0.9.0] - 2023-01-19
 

src/doc/permissions.rst

@@ -124,8 +124,8 @@ How to set permissions
 ----------------------
 
 There are multiple ways to set role and entity permissions. The most
-common and best tested way currently is to set global default entity permissions
-in the ``global_entity_permissions.xml`` config file, and role-based role
+common and best tested way currently is to set global default *entity* permissions
+in the ``global_entity_permissions.xml`` config file, and role-based *role*
 permissions with the ``caosdb_admin.py`` `utility script
 <https://gitlab.com/caosdb/caosdb-pylib/-/blob/main/src/caosdb/utils/caosdb_admin.py>`__
 of CaosDB's Python library which is also used to `manage users and
@@ -138,8 +138,8 @@ find a more detailed description of the possible ways of setting permissions.
    you can set the default permissions that every entity on the server has. The
    global default permissions can **only** be set in this file; all other ways
    below can only change the permissions of individual entities. Note that you
-   can add more rules but you can never remove rules set in the
-   ``global_entity_permissions.xml``. Thus, it might not be possible to overrule
+   can add more rules in the ``global_entity_permissions.xml``, but you can not remove rules by
+   writing to this file. Thus, it might not be possible to overrule
    permissions defined here (see :ref:`Permission
    calculation<Calculation>`). Note also that, as the name suggests, only
    :ref:`entity permissions<entity-permissions>` can be set this way. The