clean: Refactor docs on configuring who can ignore issues CY-3647 (#516)

* clean: Move "which users can ignore issues" to "roles and permissions"

* clean: Link "Configurable" cells in table to new section

* style: Tweak admonition indicating availability of feature

* clean: Link "which users can ignore issues" and "Ignoring an issue"

* fix: Adjust heading level

* fix: Update URL fragment link

* fix: Update superscript numeral

Author: prcr

docs/assets/includes/paid.txt

@@ -1,7 +1,7 @@
 <!--start-paid-->
-!!! info "This feature is [only available on paid plans](https://www.codacy.com/pricing){: target="_blank"}."
+!!! info "This feature is [only available on paid plans](https://www.codacy.com/pricing){: target="_blank"}"
 <!--end-paid-->
 
 <!--start-paid-private-repositories-->
-!!! info "Analyzing private repositories is [only available on paid plans](https://www.codacy.com/pricing){: target="_blank"}."
+!!! info "Analyzing private repositories is [only available on paid plans](https://www.codacy.com/pricing){: target="_blank"}"
 <!--end-paid-private-repositories-->

docs/organizations/configuring-which-users-can-ignore-issues.md

@@ -31,7 +31,7 @@ Depending on your role on the Git provider you will have different permissions o
     <tr>
       <td>Repository Read</td>
       <td>Yes<sup><a href="#note-2">2</a></sup></td>
-      <td>Configurable<sup><a href="#note-3">3</a></sup></td>
+      <td><a href="#configure-ignore-issues">Configurable</a></td>
       <td>No</td>
       <td>No</td>
       <td>Yes</td>
@@ -41,7 +41,7 @@ Depending on your role on the Git provider you will have different permissions o
     <tr>
       <td>Repository Triage</td>
       <td>Yes<sup><a href="#note-2">2</a></sup></td>
-      <td>Configurable<sup><a href="#note-3">3</a></sup></td>
+      <td><a href="#configure-ignore-issues">Configurable</a></td>
       <td>No</td>
       <td>No</td>
       <td>Yes</td>
@@ -51,7 +51,7 @@ Depending on your role on the Git provider you will have different permissions o
     <tr>
       <td>Repository Write</td>
       <td>Yes<sup><a href="#note-2">2</a></sup></td>
-      <td>Configurable<sup><a href="#note-3">3</a></sup></td>
+      <td><a href="#configure-ignore-issues">Configurable</a></td>
       <td>No</td>
       <td>Yes</td>
       <td>Yes</td>
@@ -61,7 +61,7 @@ Depending on your role on the Git provider you will have different permissions o
     <tr>
       <td>Repository Maintain</td>
       <td>Yes<sup><a href="#note-2">2</a></sup></td>
-      <td>Configurable<sup><a href="#note-3">3</a></sup></td>
+      <td><a href="#configure-ignore-issues">Configurable</a></td>
       <td>No</td>
       <td>Yes</td>
       <td>Yes</td>
@@ -71,7 +71,7 @@ Depending on your role on the Git provider you will have different permissions o
     <tr>
       <td>Repository Admin</td>
       <td>Yes<sup><a href="#note-2">2</a></sup></td>
-      <td>Configurable<sup><a href="#note-3">3</a></sup></td>
+      <td><a href="#configure-ignore-issues">Configurable</a></td>
       <td>Yes</td>
       <td>Yes</td>
       <td>Yes</td>
@@ -161,7 +161,7 @@ Depending on your role on the Git provider you will have different permissions o
     </tr>
     <tr>
       <td rowspan="2">Bitbucket Cloud and Bitbucket Server</td>
-      <td>Read, Write<sup><a href="#note-4">4</a></td>
+      <td>Read, Write<sup><a href="#note-3">3</a></td>
       <td>Yes<sup><a href="#note-2">2</a></sup></td>
       <td>No</td>
       <td>No</td>
@@ -185,7 +185,16 @@ Depending on your role on the Git provider you will have different permissions o
 
 <sup id="note-1">1</sup>: Outside Collaborators and External Users aren't supported as Members of organizations on Codacy. However, you can [add them](managing-people.md#adding-people) so that Codacy analyzes their commits to private repositories.<br/>
 <sup id="note-2">2</sup>: Joining an organization may need an approval depending on your setting for [accepting new people](managing-people.md#joining).<br/>
-<sup id="note-3">3</sup>: Depending on your setting for [configuring which users can ignore issues](configuring-which-users-can-ignore-issues.md).<br/>
-<sup id="note-4">4</sup>: Codacy can't distinguish the Bitbucket roles Read and Write because of a limitation on the Bitbucket API.
+<sup id="note-3">3</sup>: Codacy can't distinguish the Bitbucket roles Read and Write because of a limitation on the Bitbucket API.
 
 See [managing people](managing-people.md) to list and manage the members of your organization.
+
+## Configuring who can ignore issues {: id="configure-ignore-issues"}
+
+!!! info "Applies only to GitHub Cloud and GitHub Enterprise"
+
+By default, only users with Admin permission on a repository can [ignore issues](../repositories/issues-view.md#ignoring-an-issue), but you can change this. In your Organization's settings, you can find **Members privileges** where you can define the lowest permission required to ignore issues for your organization.
+
+![Configuring who can ignore issues](images/ignore-issues.png)
+
+Codacy doesn't allow changing the role of a user, as the roles on Codacy are mirrored from your Git provider and applied to each repository.

docs/organizations/roles-and-permissions-for-synced-organizations.md

@@ -23,10 +23,15 @@ Each pattern has a pre-defined severity level and at the moment, it's not possib
 
 ## Ignoring an issue
 
-For an issue you disagree with or false positives, you can either ignore that instance or disable the pattern across the whole repository. To do so, click on the cogwheel and select the desired option:
+You can ignore issues that you disagree with, either because they're not relevant or because you won't tackle them in the immediate future. 
+
+To do so, click on the cogwheel and select the desired option:
 
 ![Ignoring an issue](images/issues-view-ignore.gif)
 
+!!! tip
+    Organization owners can [configure who is allowed to ignore issues](../organizations/roles-and-permissions-for-synced-organizations.md#configure-ignore-issues). 
+
 ### Reinstating ignored issues
 
 To reinstate ignored issues, click on the **Current Issues** box, and select **Ignored Issues** from the drop-down menu.

docs/repositories/issues-view.md

@@ -278,8 +278,8 @@ plugins:
               "hc/en-us/articles/360012037659-GitLab-Integration.md": "repositories-configure/integrations/gitlab-integration.md"
               "hc/en-us/articles/360012056493.md": "release-notes/cloud/cloud-release-notes-|-02-november-2018.md"
               "hc/en-us/articles/360012056493-Cloud-Release-Notes-02-November-2018.md": "release-notes/cloud/cloud-release-notes-|-02-november-2018.md"
-              "hc/en-us/articles/360012126419.md": "organizations/configuring-which-users-can-ignore-issues.md"
-              "hc/en-us/articles/360012126419-How-to-configure-which-users-can-ignore-issues.md": "organizations/configuring-which-users-can-ignore-issues.md"
+              "hc/en-us/articles/360012126419.md": "organizations/roles-and-permissions-for-synced-organizations.md"
+              "hc/en-us/articles/360012126419-How-to-configure-which-users-can-ignore-issues.md": "organizations/roles-and-permissions-for-synced-organizations.md"
               "hc/en-us/articles/360012141513.md": "index.md"
               "hc/en-us/articles/360012141513-Scheduled-Maintenance-Saturday-17th-Nov-8-00-GMT-0-00-PST-.md": "index.md"
               "hc/en-us/articles/360012328140.md": "release-notes/cloud/removal-of-nodesecurity-golint-and-scsslint.md"
@@ -445,6 +445,7 @@ plugins:
               "related-tools/tool-developer-guide-using-scala.md": "related-tools/codacy-plugin-tools.md"
               "organizations/adding-and-managing-authors.md": "organizations/managing-people.md"
               "organizations/authors-vs-members.md": "organizations/managing-people.md"
+              "organizations/configuring-which-users-can-ignore-issues.md": "organizations/roles-and-permissions-for-synced-organizations.md"
               # Moved pages
               "faq/general/plan-and-billing.md": "faq/general/how-can-i-change-or-cancel-my-plan.md"
               "organizations/why-can't-i-see-my-organization.md": "faq/general/why-cant-i-see-my-organization.md"
@@ -485,7 +486,7 @@ plugins:
               "related-tools/client-side-tools.md": "related-tools/local-analysis/client-side-tools.md"
               "related-tools/run-spotbugs.md": "related-tools/local-analysis/running-spotbugs.md"
               "repositories-configure/ignore-files-from-codacy-analysis.md": "repositories-configure/ignoring-files.md"
-              "organizations/how-to-configure-which-users-can-ignore-issues.md": "organizations/configuring-which-users-can-ignore-issues.md"
+              "organizations/how-to-configure-which-users-can-ignore-issues.md": "organizations/roles-and-permissions-for-synced-organizations.md"
               "repositories/what-are-the-different-grades-and-how-are-they-calculated.md": "faq/repositories/what-are-the-different-grades-and-how-are-they-calculated.md"
               "repositories/managing-branches.md": "repositories-configure/managing-branches.md"
               "repositories/quality-settings.md": "repositories-configure/quality-settings.md"
@@ -536,7 +537,6 @@ nav:
           - organizations/managing-repositories.md
           - organizations/managing-people.md
           - organizations/roles-and-permissions-for-synced-organizations.md
-          - organizations/configuring-which-users-can-ignore-issues.md
           - Manual organizations (legacy):
                 - organizations/manual-organizations/creating-and-renaming-an-organization.md
                 - organizations/manual-organizations/creating-and-managing-teams.md