From dd24995852308ffbaa5da9a5d94d68c65b385fe2 Mon Sep 17 00:00:00 2001
From: achatterjee-grafana
 <70489351+achatterjee-grafana@users.noreply.github.com>
Date: Tue, 31 Aug 2021 10:43:13 -0400
Subject: [PATCH] Doc: Add granularity to files and folder permissions.
 (#38732)

* Added note as suggested by Simon. Also, adjusted content and resized image.

* Minor wording change.
---
 .../permissions/dashboard-folder-permissions.md        | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/docs/sources/permissions/dashboard-folder-permissions.md b/docs/sources/permissions/dashboard-folder-permissions.md
index 7a6f977cf31..c5e33f994c6 100644
--- a/docs/sources/permissions/dashboard-folder-permissions.md
+++ b/docs/sources/permissions/dashboard-folder-permissions.md
@@ -8,17 +8,13 @@ weight = 200
 
 # Grant dashboard and folder permissions
 
-You can assign and remove permissions for organization roles, users, and teams for specific dashboards and dashboard folders.
+You can assign and remove permissions for organization roles, users, and teams for specific dashboards and dashboard folders. This topic explains how to grant permissions to specific folders and dashboards. To learn more about denying access to certain Grafana users, refer to [Restricting access]({{< relref "restricting-access.md">}}).
 
-This topic explains how to grant permissions to specific folders and dashboards.
-
-To learn more about denying access to certain Grafana users, refer to [Restricting access]({{< relref "restricting-access.md">}}).
-
-![Folder permissions](/static/img/docs/permissions/folder-permissions-7-5.png)
+{{< figure src="/static/img/docs/permissions/folder-permissions-7-5.png" class="docs-image--no-shadow" max-width= "750px" caption="older permissions" >}}
 
 ## Permission levels
 
-Grafana has three permission levels that can be assigned. These permissions are separate from [organization roles]({{< relref "organization_roles.md">}}).
+There are three permission levels for files and folders. Each of the permissions is processed independently. They permissions are separate from [organization roles]({{< relref "organization_roles.md">}}).
 
 - **Admin -** Can create, edit, or delete dashboards. Can create, edit, and delete folders. Can also change dashboard and folder permissions.
 - **Edit -** Can create and edit dashboards. _Cannot_ change folder or dashboard permissions, or add, edit, or delete folders.