4 files changed, 108 insertions, 10 deletions
diff --git a/docs/pro-manual/admin-tasks.md b/docs/pro-manual/admin-tasks.md
index 3dd6e30e1..d4f48a5eb 100644
--- a/docs/pro-manual/admin-tasks.md
+++ b/docs/pro-manual/admin-tasks.md
@@ -1,15 +1,20 @@
 ---
 layout: pro
 title: Administrator tasks
-order: 4
+order: 5
 user-guide: true
 ---
 
 # Administrator tasks
 
-If you find that you cannot perform any of the tasks detailed below when logged into your FixMyStreet account, it is likely that your account has not been given the relevant permissions.
+If you find that you cannot perform any of the tasks detailed below when logged
+into your FixMyStreet account, it is likely that your account has not been
+given the relevant permissions or role.
 
-Contact your account administrator to request these permissions. Accompanying each task covered in this document, you will see ‘permissions required’, listing the checkboxes an Administrator must tick on your account for you to be able to perform this task.
+Contact your account administrator to request these permissions. Accompanying
+each task covered in this document, you will see ‘permissions required’,
+listing the permissions an Administrator must give you (either individually or
+via a role) for you to be able to perform this task.
 
 {% include admin-tasks-content.md %}
 
diff --git a/docs/pro-manual/deep-linking.md b/docs/pro-manual/deep-linking.md
new file mode 100644
index 000000000..dae9480e8
--- /dev/null
+++ b/docs/pro-manual/deep-linking.md
@@ -0,0 +1,92 @@
+---
+layout: pro
+title: FixMyStreet Pro deep linking
+order: 3
+user-guide: true
+categories: user-guide
+---
+
+# FixMyStreet Pro deep linking
+
+Your user will most likely be starting their journey of reporting an issue on
+your own website. That may be a generic report an issue page, but could be a
+page on a particular type of issue, such as Graffiti or Potholes.
+
+## Generic reporting page
+
+On a generic page, you can link directly to the FixMyStreet Pro front page with
+a normal link, or embed a FixMyStreet Pro search form into the page, taking the
+user straight to a map page.
+
+### Direct link
+
+Your website will have its own way of adding links.
+
+`<a href="https://your.fixmystreet.example/">Report a problem</a>`
+
+### Embedded form
+
+An embedded form should be a normal HTML form
+whose action is `https://your.fixmystreet.example/around` and contains a text
+input with name `pc`. Ideally it would also have a hidden field called `js`
+that is set to 1 if the user has JavaScript enabled (this can speed the response up).
+If you want to get really fancy and add geolocation to your own site, you can
+also link to an `/around` page with parameters `latitude` and `longitude`.
+
+```html
+<form action="https://your.fixmystreet.example/around">
+<label for="pc">Search term:</label>
+<input type="text" id="pc" name="pc" value="">
+<input type="submit" value="Go">
+</form>
+```
+
+## Specific category page
+
+On a category page, you can also do either of the above things, but also
+include an extra parameter that will restrict the default map view and
+reporting to a particular category, categories, or parent category if you use
+subcategories.
+
+### Direct link
+
+To link to one category, add a `filter_category` parameter with the
+category/subcategory you wish to pre-filter, or provide multiple categories
+separated by a comma (if one of your categories contains a comma, surround it
+with double quotes). If you use subcategories in your installation and wish to
+restrict the map to a particular top-level category, not an individual
+subcategory, you should use a `filter_group` parameter with the name of the
+top-level category.
+
+* https://your.fixmystreet.example/?filter_category=Graffiti
+
+* https://your.fixmystreet.example/?filter_category="A,+B,+and+C"
+
+* https://your.fixmystreet.example/?filter_category=Graffiti,Flyposting
+
+* https://your.fixmystreet.example/?filter_group=Road+defects
+
+### Embedded form
+
+Within a web form, specify the `filter_category` or `filter_group` as a hidden
+field for equivalent behaviour to the link.
+
+Using `filter_category` will restrict the map pins to that category, and
+automatically use that category when a report is begun; if you use multiple
+categories, the map is filtered but no category is selected when a report is
+begun.  Using `filter_group` will restrict the map pins to all subcategories in
+that category, preselect that category when a report is begun and the user will
+still need to pick the correct subcategory.
+
+```html
+<form action="https://your.fixmystreet.example/around">
+<input type="hidden" name="filter_category" value="Graffiti">
+<label for="pc">Search term:</label>
+<input type="text" id="pc" name="pc" value="">
+<input type="submit" value="Go">
+</form>
+```
+
+* `<input type="hidden" name="filter_group" value="Trees">`
+
+* `<input type="hidden" name="filter_category" value='Trees,"Cars, bikes, trains"'>`
diff --git a/docs/pro-manual/index.md b/docs/pro-manual/index.md
index 85ed8377f..ee5af3990 100644
--- a/docs/pro-manual/index.md
+++ b/docs/pro-manual/index.md
@@ -48,7 +48,7 @@ been developed in consultation with UK councils.
 FixMyStreet Pro offers enhanced features to client councils, including:
 -  A FixMyStreet instance for the council website, providing the council's fault-reporting
 interface, and branded to look like the rest of the site
--  A variety of permissions which can be allocated to staff at a granular level
+-  A variety of permissions which can be allocated to staff at a granular level, and grouped into custom roles
 -  Simple channels of communication with report makers, through status updates and
 template responses
 -  The ability to moderate, edit or remove reports
@@ -58,4 +58,4 @@ Depending on which type of installation the council has opted for, there may als
 -  The ability to view and update reports even when offline
 -  Workflow prioritisation and shortlist generation
 -  The integration of council-owned assets, such as bins or streetlights, into the map
-interface
-\ No newline at end of file
+interface
diff --git a/docs/pro-manual/staff-user-accounts.md b/docs/pro-manual/staff-user-accounts.md
index 3712dfcf5..37997ada2 100644
--- a/docs/pro-manual/staff-user-accounts.md
+++ b/docs/pro-manual/staff-user-accounts.md
@@ -1,7 +1,7 @@
 ---
 layout: pro
 title: FixMyStreet Pro staff user accounts
-order: 3
+order: 4
 user-guide: true
 categories: user-guide
 ---
@@ -46,13 +46,14 @@ the end of your session.
 You can change your password at any time by clicking on ‘Your account’ in the top menu bar.
 
 
-## Permissions
+## Permissions and Roles
 
-Staff accounts can be assigned a variety of permissions, depending on each team member’s needs
-or responsibilities. Permissions can be combined in any way.
+Staff accounts can be assigned a variety of permissions or roles, depending on
+each team member’s needs or responsibilities. Permissions can be combined in
+any way, grouped into custom roles, or applied individually.
 
 Some common staff roles and the appropriate permissions are shown in the table below, but you
-can tailor your permissions to best reflect your team’s operations.
+can tailor your permissions and roles to best reflect your team’s operations.
 
 
 <table class="table table--responsive">