User Guide and Reference Guide updates and restructuring

content/en/docs/apidocs-mxsdk/apidocs/private-mendix-platform/_index.md

@@ -23,7 +23,7 @@ For more information, see [API (Application Programming Interface)](https://www.
 
 ## Prerequisites
 
-Authentication for the API uses a personal access token (PAT). You can generate a PAT in the **Personal Access Tokens** section of your [Private Mendix Platform Profile](/private-mendix-platform/user-guide/#profile).
+Authentication for the API uses a personal access token (PAT). You can generate a PAT in the **Personal Access Tokens** section of your [Private Mendix Platform Profile](/private-mendix-platform/user-profile/#profile).
 
 Each available API has its own set of scopes that define the access level for the token. As a best practice, consider restricting the token's scope to the lowest access level required to perform the necessary operations.
 

content/en/docs/private-platform/reference/_index.md

@@ -1,15 +1,30 @@
 ---
-title: "Private Mendix Platform Reference Guide"
-url: /private-mendix-platform/reference-guide/
-description: "Provides details on the features and functionality of the Private Mendix Platform."
-weight: 60
+title: "Private Mendix Platform Administrator Guide"
+linktitle: "Administrator Guide"
+url: /private-mendix-platform/reference-guide/admin/
+description: "Provides details on the features and functionality of the Private Mendix Platform that are available to administrators."
+weight: 10
+aliases:
+    - /private-mendix-platform-administration/
+    - /private-mendix-platform/administration/
+    - /private-mendix-platform/reference-guide/
 ---
 
 ## Introduction
 
-The Private Mendix Platform Reference Guide provides a map of the menus and functionalities of the Private Mendix Platform. For detailed information about their use, refer to the [Private Mendix Platform User Guide](/private-mendix-platform/user-guide/).
+The Private Mendix Platform Administrator Guide provides information about the menus and functionalities of the Private Mendix Platform that are available to administrator users. For information about functionalities available for all users, refer to the [Private Mendix Platform User Guide](/private-mendix-platform/user-guide/).
 
-The reference guide has the following sections:
+## Switching to Admin Mode
 
-* [Functionalities available for all users](/private-mendix-platform/reference-guide/common/)
-* [Functionalities available for admin users](/private-mendix-platform/reference-guide/admin/)
+As an administrator, you can access the options described in this section by clicking on your user icon in the upper right corner of the screen, and then selecting **Switch to Admin Mode**.
+
+{{< figure src="/attachments/private-platform/pmp-admin5.png" class="no-border" >}}
+
+## Administrator Roles in Private Mendix Platform
+
+Private Mendix Platform distinguishes between the following types of administrator roles:
+
+* Company admin - This role primarily manages business-as-usual tasks, for example inviting new users to an app, or approving Marketplace contents. Settings relevant for company admins are available in the [Manage](/private-mendix-platform/reference-guide/admin/company/#manage) section of the admin navigation menu.
+* Systems admin - This role primarily manages key settings which must be configured during the initial implementation, and which are rarely modified during normal operation. Settings relevant for systems admins are available in the [Settings](/private-mendix-platform/reference-guide/admin/system/#settings) section of the admin navigation menu.
+
+{{< figure src="/attachments/private-platform/pmp-admin4.png" class="no-border" >}}