Better docs for edit permissions, closes #132

docs/saved-dashboards.md

@@ -4,6 +4,8 @@ A set of SQL queries can be used to create a saved dashboard. Saved dashboards h
 
 You can create a saved dashboard from the interactive dashboard interface (at `/dashboard/`) - execute some queries, then scroll down to the "Save this dashboard" form.
 
+## View permissions
+
 The following viewing permission policies are available:
 
 - `private`: Only the user who created (owns) the dashboard can view
@@ -14,6 +16,10 @@ The following viewing permission policies are available:
 - `staff`: Any user who is staff can view
 - `superuser`: Any user who is a superuser can view
 
+(edit_permissions)=
+
+## Edit permissions
+
 The edit policy controls which users are allowed to edit a dashboard - defaulting to the user who created that dashboard.
 
 Editing currently takes place through the Django Admin - so only users who are staff members with access to that interface will be able to edit their dashboards.

docs/setup.md

@@ -133,6 +133,10 @@ Access to the `/dashboard/` interface is controlled by the Django permissions sy
 
     django_sql_dashboard | dashboard | Can execute arbitrary SQL queries
 
+Dashboard editing is currently handled by the Django admin interface. This means a user needs to have **staff** status (allowing them access to the Django admin interface) in order to edit one of their saved dashboards.
+
+The regular Django permission for "can edit dashboard" is ignored. Instead, a permission system that is specific to Django SQL Dashboard is used to control edit permissions. See {ref}`edit_permissions` for details.
+
 ## Additional settings
 
 You can customize the following settings in Django's `settings.py` module: