diff --git a/docs/content/en/docs/contribution-guide/_index.md b/docs/content/en/docs/contribution-guide/_index.md
index 102f42e8a4e..63ad7c665c2 100644
--- a/docs/content/en/docs/contribution-guide/_index.md
+++ b/docs/content/en/docs/contribution-guide/_index.md
@@ -72,7 +72,10 @@ merged upstream.
 8. Learn how to [run the tests]({{< ref "/docs/contribution-guide/running-tests" >}})
    or how to [preview and contribute to the docs]({{< ref "/docs/contribution-guide/documentation" >}}).
 
-9. Learn how to [submit a pull request]({{< ref "/docs/contribution-guide/submitting-a-pull-request" >}})
-   to the project.
+9. Read how to [troubleshoot Tetragon]({{< ref "/docs/contribution-guide/troubleshooting" >}}) 
+   to resolve eventual issues.
 
-10. Please accept our gratitude for taking the time to improve Tetragon! :)
+10. Learn how to [submit a pull request]({{< ref "/docs/contribution-guide/submitting-a-pull-request" >}})
+    to the project.
+
+11. Please accept our gratitude for taking the time to improve Tetragon! :)
diff --git a/docs/content/en/docs/contribution-guide/developer-certificate-of-origin.md b/docs/content/en/docs/contribution-guide/developer-certificate-of-origin.md
index 90580613837..b7c149f9ca2 100644
--- a/docs/content/en/docs/contribution-guide/developer-certificate-of-origin.md
+++ b/docs/content/en/docs/contribution-guide/developer-certificate-of-origin.md
@@ -1,6 +1,6 @@
 ---
 title: "Developer's certificate of origin"
-weight: 6
+weight: 7
 description: "Learn about the \"sign-off\" procedure"
 ---
 
diff --git a/docs/content/en/docs/contribution-guide/submitting-a-pull-request.md b/docs/content/en/docs/contribution-guide/submitting-a-pull-request.md
index 63e6201d829..e05397e9f9a 100644
--- a/docs/content/en/docs/contribution-guide/submitting-a-pull-request.md
+++ b/docs/content/en/docs/contribution-guide/submitting-a-pull-request.md
@@ -1,6 +1,6 @@
 ---
 title: "Submitting a pull request"
-weight: 5
+weight: 6
 description: "Learn how to submit a pull request to the project"
 ---
 
diff --git a/docs/content/en/docs/troubleshooting/_index.md b/docs/content/en/docs/contribution-guide/troubleshooting.md
similarity index 95%
rename from docs/content/en/docs/troubleshooting/_index.md
rename to docs/content/en/docs/contribution-guide/troubleshooting.md
index c665ffce91d..ddb238884ed 100644
--- a/docs/content/en/docs/troubleshooting/_index.md
+++ b/docs/content/en/docs/contribution-guide/troubleshooting.md
@@ -1,8 +1,8 @@
 ---
 title: "Troubleshooting"
-weight: 11
+weight: 5
 description: Learn how to troubleshoot Tetragon
-aliases: ["/docs/tutorials/debugging-tetragon"]
+aliases: ["/docs/troubleshooting", "/docs/tutorials/debugging-tetragon"]
 ---
 
 ## Automatic log and state collection