From 788d56259ce5a5afecf052554f6bf35fcb43767d Mon Sep 17 00:00:00 2001
From: Paulo Ribeiro <paulo.ribeiro@codacy.com>
Date: Wed, 8 Sep 2021 08:29:24 +0100
Subject: [PATCH] clean: Remove page "Why can't I configure post-commit hooks
 and integrations?" (#837)

* clean: Remove page "Why can't I configure post-commit hooks and integrations?"

Moved the info from this page into a troubleshooting section in the
"Post-commit hooks" page under the repository integrations.

* clean: Link to migrate a legacy repository to a synced organization
---
 ...-i-configure-post-commit-hooks-and-integrations.md |  5 -----
 .../integrations/post-commit-hooks.md                 | 11 ++++++++++-
 mkdocs.yml                                            |  5 ++---
 3 files changed, 12 insertions(+), 9 deletions(-)
 delete mode 100644 docs/faq/troubleshooting/why-cant-i-configure-post-commit-hooks-and-integrations.md

diff --git a/docs/faq/troubleshooting/why-cant-i-configure-post-commit-hooks-and-integrations.md b/docs/faq/troubleshooting/why-cant-i-configure-post-commit-hooks-and-integrations.md
deleted file mode 100644
index 2b39837ab0..0000000000
--- a/docs/faq/troubleshooting/why-cant-i-configure-post-commit-hooks-and-integrations.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Why can't I configure post-commit hooks and integrations?
-
-Have you added your repository manually (via URL)? In that case, Codacy won't allow the integration to be added, causing the issue with post-commit hooks. To get this sorted, you will have to remove your repository and re-add it via our wizard page. 
-
-If you're still unable to configure the integration, please contact us at <mailto:support@codacy.com>.
diff --git a/docs/repositories-configure/integrations/post-commit-hooks.md b/docs/repositories-configure/integrations/post-commit-hooks.md
index ba0b7a13ed..2acb53b184 100644
--- a/docs/repositories-configure/integrations/post-commit-hooks.md
+++ b/docs/repositories-configure/integrations/post-commit-hooks.md
@@ -31,6 +31,15 @@ Here's an example of how to configure your hooks on GitHub:
 
 ![Configuring a hook on GitHub](images/webhook-example-github.gif)
 
-## Permissions to create post-commit hooks
+## Why can't I configure post-commit hooks and integrations?
+
+<!--NOTE
+    Most info in this section was moved from the page "Why can't I configure post-commit hooks and integrations?" so that the outdated troubleshooting page could be removed.
+    Make sure to clean up this section and the entire topic after the legacy manual organizations are fully discontinued.
+-->
+
+Have you added your repository manually (via URL)? In that case, Codacy won't allow the integration to be added, causing the issue with post-commit hooks. To get this sorted, you will have to [remove your repository and re-add it under a synced organization](../../faq/repositories/how-do-i-migrate-a-legacy-repository-to-a-synced-organization.md).
 
 If you get an error when turning on the post-commit hook, please make sure that you have Admin rights on the GitHub repository.
+
+If you're still unable to configure the integration, please contact us at <mailto:support@codacy.com>.
diff --git a/mkdocs.yml b/mkdocs.yml
index 111be7226e..91c7a95694 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -108,8 +108,8 @@ plugins:
               "hc/en-us/requests/new.md": "https://codacy.zendesk.com/hc/en-us/requests/new"
               "hc/en-us/articles/115000255385.md": "codacy-api/api-tokens.md"
               "hc/en-us/articles/115000255385-API-Tokens.md": "codacy-api/api-tokens.md"
-              "hc/en-us/articles/115000282129.md": "faq/troubleshooting/why-cant-i-configure-post-commit-hooks-and-integrations.md"
-              "hc/en-us/articles/115000282129-Why-can-t-I-configure-post-commit-hooks-and-integrations-.md": "faq/troubleshooting/why-cant-i-configure-post-commit-hooks-and-integrations.md"
+              "hc/en-us/articles/115000282129.md": "repositories-configure/integrations/post-commit-hooks.md"
+              "hc/en-us/articles/115000282129-Why-can-t-I-configure-post-commit-hooks-and-integrations-.md": "repositories-configure/integrations/post-commit-hooks.md"
               "hc/en-us/articles/115000488285.md": "repositories-configure/integrations/slack-integration.md"
               "hc/en-us/articles/115000488285-Slack.md": "repositories-configure/integrations/slack-integration.md"
               "hc/en-us/articles/115000566729.md": "repositories-configure/ignoring-files.md"
@@ -684,7 +684,6 @@ nav:
                 - faq/troubleshooting/why-did-codacy-stop-commenting-on-pull-requests.md
                 - faq/troubleshooting/why-arent-duplication-metrics-being-calculated.md
                 - faq/troubleshooting/why-isnt-my-public-repository-being-analyzed.md
-                - faq/troubleshooting/why-cant-i-configure-post-commit-hooks-and-integrations.md
                 - faq/troubleshooting/not-a-member-of-the-organization.md
                 - faq/troubleshooting/we-no-longer-have-access-to-this-repository.md
                 - faq/troubleshooting/why-is-my-file-over-150-kb-missing.md