From 37968083e7e85ea469066d9c4720b1a419b38eb6 Mon Sep 17 00:00:00 2001
From: Silvan Mosberger <silvan.mosberger@tweag.io>
Date: Wed, 2 Aug 2023 18:38:44 +0200
Subject: [PATCH] CONTRIBUTING.md: Move opening issues section to Nixpkgs
 manual

This isn't relevant to contributors specifically, it applies to all
users
---
 CONTRIBUTING.md                           | 6 ------
 doc/development.md                        | 6 +++++-
 doc/development/opening-issues.chapter.md | 7 +++++++
 3 files changed, 12 insertions(+), 7 deletions(-)
 create mode 100644 doc/development/opening-issues.chapter.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 95d23e3f7ed..7a2ea329ded 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,11 +1,5 @@
 # How to contribute
 
-## Opening issues
-
-* Make sure you have a [GitHub account](https://github.com/signup/free)
-* Make sure there is no open issue on the topic
-* [Submit a new issue](https://github.com/NixOS/nixpkgs/issues/new/choose) by choosing the kind of topic and fill out the template
-
 ## Submitting changes
 
 Read the ["Submitting changes"](https://nixos.org/nixpkgs/manual/#chap-submitting-changes) section of the nixpkgs manual. It explains how to write, test, and iterate on your change, and which branch to base your pull request against.
diff --git a/doc/development.md b/doc/development.md
index d1b479b6cd8..0c092befca2 100644
--- a/doc/development.md
+++ b/doc/development.md
@@ -3,4 +3,8 @@
 This section shows you how Nixpkgs is being developed and how you can interact with the contributors and the latest updates.
 If you are interested in contributing yourself, see [CONTRIBUTING.md](https://github.com/NixOS/nixpkgs/blob/master/CONTRIBUTING.md).
 
-<!-- In the future this section should also include: How to open issues (request backports, request updates, report bugs, ...), how to test pull requests, how to know if pull requests are available in channels, etc. -->
+<!-- In the future this section should also include: How to test pull requests, how to know if pull requests are available in channels, etc. -->
+
+```{=include=} chapters
+development/opening-issues.chapter.md
+```
diff --git a/doc/development/opening-issues.chapter.md b/doc/development/opening-issues.chapter.md
new file mode 100644
index 00000000000..2b82efae593
--- /dev/null
+++ b/doc/development/opening-issues.chapter.md
@@ -0,0 +1,7 @@
+# Opening issues {#sec-opening-issues}
+
+* Make sure you have a [GitHub account](https://github.com/signup/free)
+* Make sure there is no open issue on the topic
+* [Submit a new issue](https://github.com/NixOS/nixpkgs/issues/new/choose) by choosing the kind of topic and fill out the template
+
+<!-- In the future this section could also include more detailed information on the issue templates -->