docs: first draft of dashboard folders docs

docs/sources/reference/dashboard_folders.md

@@ -0,0 +1,97 @@
++++
+title = "Dashboard Folders"
+keywords = ["grafana", "dashboard", "dashboard folders", "folder", "folders", "documentation", "guide"]
+type = "docs"
+[menu.docs]
+name = "Folders"
+parent = "dashboard_features"
+weight = 3
++++
+
+# Dashboard Folders
+
+Folders are a way to organize and group dashboards - very useful if you have a lot of dashboards or multiple teams using the same Grafana instance.
+
+## How To Create A Folder
+
+- Create a folder by using the Create Folder link in the side menu.
+
+    ![](/img/docs/v50/create_folder_menu.png)
+
+- Use the create Folder button on the Manage Dashboards page.
+
+- When saving a dashboard, you can either choose a folder for the dashboard to be saved in or create a new folder (coming in 5.0 beta)
+
+On the Create Folder page, fill in a unique name for the folder and press Create.
+
+![](/img/docs/v50/create_folder_page.png)
+
+## Manage Dashboards
+
+There is a new Manage Dashboards page where you can carry out a variety of tasks:
+
+- create a folder
+- create a dashboard
+- move dashboards into folders
+- delete multiple dashboards
+- navigate to a folder page (where you can set permissions for a folder and/or its dashboards)
+
+There is a new option in the Dashboards menu for the Manage Dashboards page:
+
+  ![](/img/docs/v50/manage_dashboard_menu.png)
+
+Here you can manage your dashboards:
+
+![](/img/docs/v50/manage_dashboards_page.png)
+
+Or you can go directly to a Dashboard Folder page via Dashboard Search by clicking on the cog icon:
+
+![](/img/docs/v50/go_to_dashboard_folder_page.png)
+
+## Dashboard Folder Page
+
+The Dashboard Folder Page is similar to the Manage Dashboards page and is where you can carry out the following tasks:
+
+- allows you to move or delete dashboards in a folder.
+- rename a folder (under the Settings tab).
+- set permissions on the whole folder.
+- set permissions on a single dashboard.
+
+## Dashboard Permissions (Not enabled in Grafana 5.0 alpha)
+
+An Access Control List (ACL) model is used for permissions on Dashboard Folders. An individual user can be assigned permissions on a folder or a Team.
+
+The permissions that can be assigned for a folder are: View, Edit, Admin.
+
+The default is that:
+
+- everyone has access to a folder and that their permissions depend on their user role (Viewer, Editor or Admin).
+- An Admin or Editor can remove the default access for everyone and can then assign a user or team to a Dashboard Folder.
+- Teams make it easier to assign permissions for multiple users to multiple dashboards.
+
+Other Dashboard Folder rules:
+
+- Users with the Admin and Editor role are allowed to create new Dashboard Folders.
+- Users with the Viewer role are not allowed to create new Dashboard Folders.
+- Editors who are owners and Admins can assign permissions to users or teams for Dashboard Folders.
+- Default permissions can be removed except for the Admin permissions (View, Edit). 
+
+### Limiting Permissions on a Folder
+
+To limit permissions on a folder or dashboard:
+
+1. go to the permissions tab on the Dashboard Folder page
+2. remove the default permissions (Everyone with Editor Role / Everyone with Viewer Role)
+3. Give a team or user specific permissions. For example: `frontend-team can edit` and `ops-team can view`.
+
+Remember that users with the Admin role will always have permission to all folders and dashboards.
+
+## Teams (Not enabled in Grafana 5.0 alpha)
+
+Teams is a new concept for Grafana 5.0. A team is a group of users that can be assigned permissions on a dashboard folder or a dashboard.
+
+How Teams Work:
+
+- Admins can create teams.
+- No hierarchies. Teams cannot contain teams.
+- If a user belongs to multiple teams, their permissions are merged to give them the highest permission possible for a dashboard folder or dashboard.