dhis2-devs team mailing list archive

[noreply@xxxxxxxxxxxxx]

------------------------------------------------------------
revno: 707
committer: Lars Helge Øverland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Thu 2013-03-21 00:32:23 +0100
message:
  Sharing update
modified:
  src/docbkx/en/dhis2_user_man_sharing.xml


--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs

Your team DHIS 2 developers is subscribed to branch lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription

=== modified file 'src/docbkx/en/dhis2_user_man_sharing.xml'
--- src/docbkx/en/dhis2_user_man_sharing.xml	2013-03-17 16:32:07 +0000
+++ src/docbkx/en/dhis2_user_man_sharing.xml	2013-03-20 23:32:23 +0000
@@ -27,10 +27,11 @@
       </mediaobject>
     </screenshot>
     <para>You can share your report with everyone or with a number of user groups. Next to "Public
-      access" you can choose your access option: "None", "Can view" or "Can edit and view". To share
-      with a group, simply start typing the name of the group and the "Search for user groups" input
-      field and select your desired group. Click on the "+" icon next to the input field to share
-      with that group. For each group you can set an access option, similar to public access.</para>
+      access" you can choose your access option: "None", "Can view" or "Can edit and view". Edit
+      implies both updating and deleting the report. To share with a group, simply start typing the
+      name of the group and the "Search for user groups" input field and select your desired group.
+      Click on the "+" icon next to the input field to share with that group. For each group you can
+      set an access option, similar to public access.</para>
     <para>Sharing with a user group implies that all users in that group will get access to the
       shared object. To create a user group you can go to the dashboard module and click on "Groups"
       on the front page. This will lead you to the list of groups where you can click "Add new" in
@@ -38,26 +39,31 @@
   </section>
   <section>
     <title>Sharing and access control</title>
-    <para>Currently the objects which support sharing are indicator, indicator group, indicator
-      group set, data dictionary, data set, program, user group, standard report, resource, report
-      table, chart and map. </para>
-    <para>In order to be able to create objects with public access (view or edit) your user account
-      must have the authority to do so. All supported objects have a corresponding authority for
-      creating public objects. As an example, to create a publicly accessible report your user must
-      have the "Create public report" authority granted. The public access option will be disabled
-      if not.</para>
-    <para>To share an object with another person and let her edit the object will in most cases
-      require that the person's user account has the authority for updating that type of objects
-      granted. For instance, if you want to let another person edit your report, that person's user
-      account must have the "Update report" authority granted. This does not apply for objects which
-      are open for anyone to create, which currently are report table, map, chart and user
-      group.</para>
+    <para>The objects which support sharing are indicator, indicator group, indicator group set,
+      data dictionary, data set, program, standard report, resource, report table, chart, map and
+      user group. Out of those objects, report table, chart, map and user group are open for
+      everyone to create privately. Private means that the objects are available only to yourself or
+      potentially to a number of user groups. These objects are referred to as "open" objects. The
+      reminaing objects require that your user account has the authority to create them. These
+      objects are referred to as "non-open" objects.</para>
+    <para>A user can be granted the authority to create publicly accessible objects or privately
+      accessible objects. In order to create a publicly accessible object (available for viewing or
+      editing by anyone) your user account must have the authority to do so. As an example, to
+      create a publicly accessible chart, your user must have the "Create public chart" authority
+      granted. The authority to create private objects applies only to non-open objects. For
+      example, to allow a user to create indicators which will only be accessible to that user and
+      not to everyone, the user can be issued with the "Create private indicator" authority.</para>
+    <para>To share a non-open object with another person and let her edit the object requires that
+      the person's user account has the authority for updating that type of objects granted. For
+      instance, if you want to let another person edit your indicator, that person's user account
+      must have the "Update indicator" authority granted. This does not apply for open
+      objects.</para>
     <para>When you create an object it will automatically become viewable for everyone if your user
-      account has the authority to do so. As an example, if you create a report and you have the
-      "Create public report" authority granted, the report will become viewable for everyone and
-      editable for users with the "Update report" authority. If you do not have that authority
-      granted the report will be private to yourself. After you have created an object, you can
-      navigate to the "Sharing settings" dialog and set your desired access options.</para>
+      account has the authority to create public objects. As an example, if you create a standard
+      report and you have the "Create public standard report" authority granted, the report will
+      become viewable for everyone. If you do not have that authority granted the report will be
+      private to yourself. After you have created an object, you can navigate to the "Sharing
+      settings" dialog and set your desired access control level.</para>
     <para>If you need a user account which is able to view absolutely all objects you can create a
       user role with the "ALL" authority and assign a user to that role. If you need to switch
       between a "complete" view of objects and a "personal" view of objects it is recommended to