# HG changeset patch
# User Marcin Kuzminski <marcin@rhodecode.com>
# Date 2019-05-06 08:19:26
# Node ID b7b32afdfdfc3646669a5f24022bb30b590524b8
# Parent  ade8a2ddd265a0f20daa06be3ef4747c269339ad

docs: personal repo group manual set instructions

diff --git a/docs/admin/user-admin.rst b/docs/admin/user-admin.rst
--- a/docs/admin/user-admin.rst
+++ b/docs/admin/user-admin.rst
@@ -13,11 +13,12 @@ permissions applied to it; |perm|.
 
 .. toctree::
 
-    public-access
-    default-user-perms
-    adding-anonymous-user
-    adding-new-user
-    setting-default-permissions
-    setting-usergroup-permissions
+    user_admin/public-access
+    user_admin/default-user-perms
+    user_admin/adding-anonymous-user
+    user_admin/adding-new-user
+    user_admin/setting-default-permissions
+    user_admin/setting-usergroup-permissions
+    user_admin/user-admin-tasks
 
-.. |perm| replace:: **None**, **Read**, **Write**, or **Admin**
\ No newline at end of file
+.. |perm| replace:: **None**, **Read**, **Write**, or **Admin**
diff --git a/docs/admin/adding-anonymous-user.rst b/docs/admin/user_admin/adding-anonymous-user.rst
rename from docs/admin/adding-anonymous-user.rst
rename to docs/admin/user_admin/adding-anonymous-user.rst
diff --git a/docs/admin/adding-new-user.rst b/docs/admin/user_admin/adding-new-user.rst
rename from docs/admin/adding-new-user.rst
rename to docs/admin/user_admin/adding-new-user.rst
diff --git a/docs/admin/default-user-perms.rst b/docs/admin/user_admin/default-user-perms.rst
rename from docs/admin/default-user-perms.rst
rename to docs/admin/user_admin/default-user-perms.rst
diff --git a/docs/admin/public-access.rst b/docs/admin/user_admin/public-access.rst
rename from docs/admin/public-access.rst
rename to docs/admin/user_admin/public-access.rst
diff --git a/docs/admin/setting-default-permissions.rst b/docs/admin/user_admin/setting-default-permissions.rst
rename from docs/admin/setting-default-permissions.rst
rename to docs/admin/user_admin/setting-default-permissions.rst
diff --git a/docs/admin/setting-usergroup-permissions.rst b/docs/admin/user_admin/setting-usergroup-permissions.rst
rename from docs/admin/setting-usergroup-permissions.rst
rename to docs/admin/user_admin/setting-usergroup-permissions.rst
diff --git a/docs/admin/user_admin/user-admin-tasks.rst b/docs/admin/user_admin/user-admin-tasks.rst
new file mode 100644
--- /dev/null
+++ b/docs/admin/user_admin/user-admin-tasks.rst
@@ -0,0 +1,24 @@
+.. _user-admin-tasks:
+
+Common Admin Tasks for Users
+----------------------------
+
+
+Manually Set Personal Repository Group
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Here is how to set a repository group as personal for a user using ishell.
+
+
+.. code-block:: bash
+
+    # starts the ishell interactive prompt
+    $ rccontrol ishell enterprise-1
+
+.. code-block:: python
+
+    In [1]: repo_group = RepoGroup.get_by_group_name('some_group_name')
+    In [2]: user = User.get_by_username('some_user')
+    In [3]: repo_group.user = user
+    In [4]: repo_group.personal = True
+    In [5]: Session().add(repo_group);Session().commit()
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -64,6 +64,13 @@ and commit files and |repos| while manag
 
 .. toctree::
    :maxdepth: 1
+   :caption: User Documentation
+
+   usage/basic-usage
+   tutorials/tutorials
+
+.. toctree::
+   :maxdepth: 1
    :caption: Developer Documentation
 
    api/api
@@ -73,13 +80,6 @@ and commit files and |repos| while manag
 
 .. toctree::
    :maxdepth: 1
-   :caption: User Documentation
-
-   usage/basic-usage
-   tutorials/tutorials
-
-.. toctree::
-   :maxdepth: 1
    :caption: About
 
    known-issues/known-issues