diff --git a/src/python/PyBis/README.md b/src/python/PyBis/README.md
index 94dc84333b63bfac4ede3513ef9b80396ee3b7bf..34b4c698bd8844b81caabc829982cc9410d43d23 100644
--- a/src/python/PyBis/README.md
+++ b/src/python/PyBis/README.md
@@ -49,10 +49,18 @@ o.get_persons()
 person = o.new_person(userId='username')
 person.space = 'USER_SPACE'
 person.save()
-person.assign_role(role='ADMIN', space='DEFAULT')
-person.get_roles()
-person.revoke_role(role='ADMIN', space='DEFAULT')
 
+person.assign_role(role='ADMIN', space='MY_SPACE')
+person.assign_role(role='OBSERVER')
+person.get_roles()
+person.revoke_role(role='ADMIN', space='MY_SPACE')
+person.revoke_role(role='OBSERVER')
+
+o.get_role_assignments()
+o.get_role_assignments(space='MY_SPACE')
+o.get_role_assignments(group='MY_GROUP')
+ra = o.get_role_assignment(techId)
+ra.delete()
 ```
 
 
@@ -273,6 +281,8 @@ new_tag = o.new_tag('my_tag', description='some descriptive text')
 new_tag.save()
 o.get_tags()
 tag = o.get_tag('/username/TAG_Name')
+tag.description = 'some new description'
+tag.save()
 tag.get_experiments()
 tag.get_samples()
 tag.delete()
diff --git a/src/python/PyBis/README.rst b/src/python/PyBis/README.rst
index 276cada835f86ea56c4082fcd39338886b9bb582..fce8582e92f51d9b1eef6f55132b1e24417a00c2 100644
--- a/src/python/PyBis/README.rst
+++ b/src/python/PyBis/README.rst
@@ -38,6 +38,41 @@ Masterdata
     o.get_terms('MATING_TYPE')
     o.get_tags()
 
+Users, Groups and RoleAssignments
+---------------------------------
+
+::
+
+    o.get_groups()
+    group = o.new_group(code='group_name', description='...')
+    group = o.get_group('group_name')
+    group.save()
+    group.assign_role(role='ADMIN', space='DEFAULT')
+    group.get_roles() 
+    group.revoke_role(role='ADMIN', space='DEFAULT')
+
+    group.add_persons(['admin'])
+    group.get_persons()
+    group.del_persons(['admin'])
+    group.delete()
+
+    o.get_persons()
+    person = o.new_person(userId='username')
+    person.space = 'USER_SPACE'
+    person.save()
+
+    person.assign_role(role='ADMIN', space='MY_SPACE')
+    person.assign_role(role='OBSERVER')
+    person.get_roles()
+    person.revoke_role(role='ADMIN', space='MY_SPACE')
+    person.revoke_role(role='OBSERVER')
+
+    o.get_role_assignments()
+    o.get_role_assignments(space='MY_SPACE')
+    o.get_role_assignments(group='MY_GROUP')
+    ra = o.get_role_assignment(techId)
+    ra.delete()
+
 Spaces
 ------
 
@@ -260,6 +295,21 @@ Semantic Annotations
     # delete semantic annotation
     sa.delete('reason')
 
+Tags
+----
+
+::
+
+    new_tag = o.new_tag('my_tag', description='some descriptive text')
+    new_tag.save()
+    o.get_tags()
+    tag = o.get_tag('/username/TAG_Name')
+    tag.description = 'some new description'
+    tag.save()
+    tag.get_experiments()
+    tag.get_samples()
+    tag.delete()
+
 Requirements and organization
 =============================
 
diff --git a/src/python/PyBis/setup.py b/src/python/PyBis/setup.py
index 6ff878f5bc64d0ef5ebe266998b62d8172958eaf..43389bb51e00cb5127393689cd70e3900e659b26 100644
--- a/src/python/PyBis/setup.py
+++ b/src/python/PyBis/setup.py
@@ -9,7 +9,7 @@ from setuptools import setup
 
 setup(
     name='PyBIS',
-    version= '1.5.0',
+    version= '1.6.0',
     description='openBIS connection and interaction, optimized for using with Jupyter',
     url='https://sissource.ethz.ch/sispub/pybis/',
     author='Swen Vermeul |  ID SIS | ETH Zürich',