DOCS-1409 - Proof the Manage Account guide

docs/manage/content-sharing/admin-mode.md

@@ -7,42 +7,42 @@ description: Admin mode allows you to control the content for your organization
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-As a Content Administrator, you can assume a super user role within Sumo. When you need to manage the content for your organization, you can choose the Content Administrator role which will turn off your personal content in the Library and allow you to see the entire Sumo file tree. 
+As a content administrator with the [Manage Content](/docs/manage/users-roles/roles/role-capabilities/#data-management) role capability, you can assume a super user role within Sumo Logic. When you need to manage the content for your organization, you can choose the content administrator role which will turn off your personal content in the library and allow you to see the entire Sumo Logic file tree. 
 
 In this mode, you can migrate content from one location to another, as well as highlight important content in the Admin Recommended folder. 
 
-## Switch to Admin Mode
+## Switch to admin mode
 
-As a Content Administrator,  you can switch to Admin mode at any time in order to move content from one folder to another for anyone in your organization.  
+As a content administrator,  you can switch to admin mode at any time in order to move content from one folder to another for anyone in your organization.  
 
-To switch to Admin Mode:
+To switch to admin mode:
 
 1. Go to the Library.
 1. Select **View as:** > **Content Administrator.** <br/>  <img src={useBaseUrl('img/content-sharing/content-admin.png')} alt="Admin Mode" style={{border: '1px solid gray'}} width="200" />
 
-You will now see the whole file tree for your organization, as well as the **Admin Recommended** folder.
+You will now see the whole file tree for your organization, as well as the Admin Recommended folder.
 
 ## Move important content to Admin Recommended
 
-Important content can be dashboards that help new users get started, or common searches that your organization needs often. You can draw attention to this content by putting it into **Admin Recommended**, which appears at the top of the Library in the Left-Nav.
+Important content can be dashboards that help new users get started, or common searches that your organization needs often. You can draw attention to this content by putting it into Admin Recommended, which appears at the top of the Library in the left navigation bar.
 
-For example, you can content share an Audit dashboard at the top of the Library on the Left-nav with a particular role such as Administrators and move it into Admin Recommended. All Sumo Administrators will be able to see it there, but any user without that role, will not see the dashboard.
+For example, you can content share an audit dashboard at the top of the Library on the left navigation bar with a particular role such as Administrators and move it into Admin Recommended. All Sumo Logic users with the Administrators role will be able to see it there, but any user without that role, will not see the dashboard.
 
 <img src={useBaseUrl('img/content-sharing/admin-rec.png')} alt="Admin Recommended" style={{border: '1px solid gray'}} width="500" />
 
 To add a dashboard or search to Admin Recommended:
 
-1. Select the Library Tab from the UI.
-1. Toggle to Content Administrator mode. 
-1. A note loads on the Left-nav that says **Viewing as Content Administrator**. This is to help you remember why your Personal folder doesn't appear.
-1. Make sure you've [shared the search](/docs/manage/content-sharing), dashboard, or folder with the role or users that you want to be able to access it.
+1. Select the **Library** tab from the UI.
+1. Toggle to **Content Administrator** mode. 
+1. A note loads on the left navigation bar that says **Viewing as Content Administrator**. This is to help you remember why your Personal folder doesn't appear.
+1. Make sure you've [shared](/docs/manage/content-sharing) the search, dashboard, or folder with the role or users that you want to be able to access it.
 1. Select the options menu for the item you want to move, and choose **Move.**
-1. From the Move dialog, choose the **Admin Recommended** folder and click **Move**.
+1. From the **Move** dialog, choose the **Admin Recommended** folder and click **Move**.
 
 :::note
 Remember to switch out of Content Administrator viewing when you are done.
 :::
 
 ## Track content changes in your org
 
-If you need to track what content has been shared in your organization, or recently changed by another Content Administrator, you can find dashboards to help you track that information in the [Audit App](/docs/integrations/sumo-apps/audit).
+If you need to track what content has been shared in your organization, or recently changed by another content administrator, you can find dashboards to help you track that information in the [Sumo Logic Audit app](/docs/integrations/sumo-apps/audit).

docs/manage/content-sharing/changing-alerts.md

@@ -6,13 +6,13 @@ description: You can modify or cancel alerts that are no longer valuable to your
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-The ability to modify or turn off alerts created by another user is now possible with Content Sharing. Sometimes the need or frequency of a log alert changes while the creator is unavailable and with Content Sharing you can give that ability to another Role or user within your Organization.
+The ability to modify or turn off alerts created by another user is possible with content sharing. Sometimes the need or frequency of a log alert changes while the creator is unavailable, and with content sharing you can give that ability to another role or user within your organization.
 
-We strongly recommend sharing your scheduled searches with at least one Role or a user you trust to allow you more flexibility with alerts.
+We strongly recommend sharing your scheduled searches with at least one role or a user you trust to allow you more flexibility with alerts.
 
 ## Edit an alert
 
-If you or your role has Edit permissions on a scheduled search you can modify the frequency and type of alert as well as the query if you need to make any adjustments such as the threshold or timeslice.
+If you or your role has edit permissions on a scheduled search you can modify the frequency and type of alert as well as the query if you need to make any adjustments such as the threshold or timeslice.
 
 :::note
 If you're using a search template with your saved search, you cannot modify the query from the alert.
@@ -29,7 +29,7 @@ To edit an alert:
 
 ## Cancel alerts on a shared search
 
-If you have Edit permissions on the shared search, you can stop recipients from receiving alerts by setting the run frequency to **Never**. We recommend doing this when a search is no longer relevant rather than deleting the search so that it can be available to you later if you need it. Deleting the shared search is possible, if you have Manage permissions, but does not allow you the ability to restore a scheduled search later if you need it.
+If you have edit permissions on the shared search, you can stop recipients from receiving alerts by setting the run frequency to **Never**. We recommend doing this when a search is no longer relevant rather than deleting the search so that it can be available to you later if you need it. Deleting the shared search is possible if you have manage permissions, but does not allow you the ability to restore a scheduled search later if you need it.
 
 1. Navigate to the scheduled search you want to edit, as described above in [Edit an alert](#edit-an-alert).
 1. Select the edit icon in the library for the scheduled search.<br/><img src={useBaseUrl('img/content-sharing/EditAlert.png')} alt="Select the edit icon in the library" style={{border: '1px solid gray'}} width="800" />

docs/manage/content-sharing/content-sharing-faq.md

@@ -5,63 +5,60 @@ sidebar_label: FAQ
 description: This FAQ answers your basic questions around content sharing.
 ---
 
-Welcome to Content Sharing. We've provided this FAQ to answer your basic questions around the interface changes that come with Content Sharing.
+This FAQ answers your basic questions about Sumo Logic content sharing.
 
 ## When I share something with someone, how will they see it?
 
-When you share something directly with a user (or to their role) they will receive an email notification that they can click on to guide them to the item in Sumo.
+When you share something directly with a user (or with their role) they will receive an email notification that they can click on to guide them to the item in Sumo Logic.
 
 * The object will also be available in their Library view.
-* They can also look in **Recent** in the left-nav to see what has been recently shared.
+* They can also look in **Recent** in the left navigation bar to see what has been recently shared.
 * The share dialog associated with the item will reflect who the item is shared with and what level of access they have.
 
 ## Can I delete someone else's alerts?
 
-Yes, IF you have Edit permissions on that shared search. You need Edit permissions at a minimum on the shared search to make any changes to the associated alert. For details, see [Changing Alerts](changing-alerts.md).
+Yes, if you have edit permissions on that shared search. You need edit permissions at a minimum on the shared search to make any changes to the associated alert. For details, see [Changing Other Alerts](changing-alerts.md).
 
-## I shared something with my coworker but they can’t see it in their Library view?
+## I shared something with my coworker, but why can't they see it in their Library view?
 
-It is possible that you shared an item that is nested within a folder. The Library view is designed to roll-up to the highest level parent folder. Have them check their **Recently Shared with Me** dialog. Or, send your co-worker the name of the item and they can also search for it in the Library.
+It is possible that you shared an item that is nested within a folder. The Library view is designed to roll up to the highest level parent folder. Have them check their **Recently Shared with Me** dialog. Or, send your co-worker the name of the item and they can also search for it in the Library.
 
-## Can shared dashboards always run with viewer's role search filter instead of the creator's role search filter?
+## Can shared dashboards always run with the viewer's role search filter instead of the creator's role search filter?
 
 Yes, for an individual dashboard, when you share the dashboard you can choose to share it with the "Viewer’s data access level", so that
 viewers will see it with their own role search filter. For more information, see [Set the Data Access Level for a Dashboard](/docs/dashboards/set-data-access-level). In addition, it is possible to set a security policy that ensures that all new dashboards will run with the viewer’s role search filter when shared. For more information, see [Data Access Level for Shared Dashboards](../security/data-access-level-shared-dashboards.md). 
 
 ## Can I share a folder with someone?
 
-Yes, you can share a folder you manage with anyone or any role in your Org. Keep in mind that when you share a folder, that person will have access to all items within that folder as well as any nested sub-folders. Try to limit sharing at the folder level and grant permissions to sub-folders or individual items.
+Yes, you can share a folder you manage with anyone or any role in your organization. Keep in mind that when you share a folder, that person will have access to all items within that folder as well as any nested sub-folders. Try to limit sharing at the folder level and grant permissions to sub-folders or individual items.
 
 ## What if I shared a folder with someone with edit access but then gave them view access on a specific dashboard in that folder?
 
-We also allow the most permissive set of permissions. In this case, the highest permission the user has on the dashboard is edit - so that’s how they can access it.
+We also allow the most permissive set of permissions. In this case, the highest permission the user has on the dashboard is edit, so that’s how they can access it.
 
-## Can I share a folder with a role with edit permissions the limit items in folder from editing?
+## Can I share a folder with a role with edit permissions that limit items in a folder from editing?
 
 No. We do not support the concept of negative permissions. Users will always get the highest level of permissions available to them on an
 item.
 
 We recommend a strategy of providing the lowest level of access (view) to the broad group of users and limiting higher level of access to only a trusted few.
 
-## Can I control what objects a specific role can access using the Roles page?
+## Can I control what objects a specific role can access using the [Roles](/docs/manage/users-roles/roles/create-manage-roles/) page?
 
 No. Access control is managed at the object level, in the Library.
 
 ## I want to create a hierarchy of folders for my company so that each team knows exactly where to put their content. How can I do this?
 
-This can be achieved by a feature available to administrators called
-**Admin View**. Users who are in a role that has the capability Manage
-Content set, can see this view.
+This can be achieved by a feature available to administrators called *Admin View*. Users who are in a role with the [Manage Content](/docs/manage/users-roles/roles/role-capabilities/#data-management) role capability can see this view.
 
-* When in this view, Administrators have manage access on all objects in the org.
-* They also have access to a special folder called **Admin Recommended**. Anything that is placed in this folder and shared out to a user or role, is displayed at the top of the library, in the Admin recommended section.
+* When in this view, administrators have manage access on all objects in the org.
+* They also have access to a special folder called Admin Recommended. Anything that is placed in this folder, and shared out to a user or role, is displayed at the top of the library in the Admin Recommended section.
 * Administrators can create a folder hierarchy within this view and share it out to the org with view permissions. Certain roles can have edit or manage access to the folder that is specific to the team, so they can move their content in.
 
 ## What is this Data Access setting that pops up whenever I try to edit a dashboard?
 
-Dashboards run with the data access level of a particular user. We wanted to prevent users from making edits to a dashboard that would enable them to see more data than they were allowed to. When a user attempts to edit a query, we compare the editor’s data access to the current Run-as user of the dashboard. If the access level is lower, we ask the editor to change the Run-as user to themselves before they can save their change.
+Dashboards run with the data access level of a particular user. We wanted to prevent users from making edits to a dashboard that would enable them to see more data than they were allowed to. When a user attempts to edit a query, we compare the editor’s data access to the current run-as user of the dashboard. If the access level is lower, we ask the editor to change the run-as user to themselves before they can save their change.
 
-## I'm an Admin, how do I monitor content sharing activity in my org?
+## As an admin, how do I monitor content sharing activity in my org?
 
-All permission updates, move, copy and delete actions in the content library are audited. All actions performed by the user while in Admin
-mode are also audited. The [Audit App](/docs/integrations/sumo-apps/audit) has been updated with several new dashboards that visualize this activity for you.
+All permission updates, move, copy and delete actions in the content library are audited. All actions performed by the user while in admin mode are also audited. The [Sumo Logic Audit app](/docs/integrations/sumo-apps/audit) has been updated with several new dashboards that visualize this activity for you.

docs/manage/content-sharing/index.md

@@ -108,7 +108,7 @@ In this section, we'll introduce the following concepts:
 <div className="box smallbox card">
   <div className="container">
   <a href={useBaseUrl('docs/manage/content-sharing/content-sharing-faq')}><img src={useBaseUrl('img/icons/business/networking.png')} alt="icon" width="40"/><h4>FAQ</h4></a>
-  <p>Get to know the answers to basic questions around Content Sharing.</p>
+  <p>Get to know the answers to basic questions around content sharing.</p>
   </div>
 </div>
 </div>