From c81a963b113b5cf30285ee84393ccbc681347293 Mon Sep 17 00:00:00 2001
From: TimTheBig <132001783+TimTheBig@users.noreply.github.com>
Date: Thu, 9 Nov 2023 12:19:52 -0500
Subject: [PATCH] to dev (#2)
* Update CONTRIBUTING.md
Signed-off-by: TimTheBig <132001783+TimTheBig@users.noreply.github.com>
* Update CONTRIBUTING.md
Signed-off-by: TimTheBig <132001783+TimTheBig@users.noreply.github.com>
* Update CONTRIBUTING.md
Signed-off-by: TimTheBig <132001783+TimTheBig@users.noreply.github.com>
* Update CONTRIBUTING.md
Signed-off-by: TimTheBig <132001783+TimTheBig@users.noreply.github.com>
* Update CONTRIBUTING.md
Signed-off-by: TimTheBig <132001783+TimTheBig@users.noreply.github.com>
---------
Signed-off-by: TimTheBig <132001783+TimTheBig@users.noreply.github.com>
---
CONTRIBUTING.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 55 insertions(+), 1 deletion(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1ea98df2..efe6ac33 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -2,4 +2,58 @@
Please read and understand the contribution guide before creating an issue or pull request.
-The guide can be found here: [https://docs.pi-hole.net/guides/github/contributing/](https://docs.pi-hole.net/guides/github/contributing/)
+The full guide can be found here: [https://docs.pi-hole.net/guides/github/contributing/](https://docs.pi-hole.net/guides/github/contributing/)
+
+Please read and understand the contribution guide before creating an issue or pull request.
+
+Etiquette
+
+ Our goal for Pi-hole is stability before features. This means we focus on squashing critical bugs before adding new features. Often, we can do both in tandem, but bugs will take priority over a new feature.
+
+ Pi-hole is open source and [powered by donations](https://pi-hole.net/donate/), and as such, we give our free time to build, maintain, and provide user support for this project. It would be extremely unfair for us to suffer abuse or anger for our hard work, so please take a moment to consider that.
+
+ Please be considerate towards the developers and other users when raising issues or presenting pull requests.
+ Respect our decision(s), and do not be upset or abusive if your submission is not used.
+
+Viability
+
+When requesting or submitting new features, first consider whether it might be useful to others. Open source projects are used by many people, who may have entirely different needs to your own. Think about whether or not your feature is likely to be used by other users of the project.
+
+Procedure
+
+ Before filing an issue:
+
+ - Attempt to replicate and document the problem, to ensure that it wasn't a coincidental incident.
+
+ - Check to make sure your feature suggestion isn't already present within the project.
+
+ - Check the pull requests tab to ensure that the bug doesn't have a fix in progress.
+
+ - Check the pull requests tab to ensure that the feature isn't already in progress.
+
+
+Before submitting a pull request:
+
+ - Check the codebase to ensure that your feature doesn't already exist.
+
+ - Check the pull requests to ensure that another person hasn't already submitted the feature or fix.
+
+ - Read and understand the [DCO guidelines](https://docs.pi-hole.net/guides/github/dco/) for the project.
+
+
+Technical Requirements:
+
+ - Submit Pull Requests to the development branch only.
+
+ - Before Submitting your Pull Request, merge development with your new branch and fix any conflicts. (Make sure you don't break anything in development!)
+
+ - Please use the [Google Style Guide](https://google.github.io/styleguide/shellguide.html) for Shell for your code submission styles.
+
+ - Commit Unix line endings.
+
+ - Please use the Pi-hole brand: Pi-hole (Take a special look at the capitalized 'P' and a low 'h' with a hyphen)
+
+ - For Beginners: see here [how to forking and clone from GitHub](https://docs.pi-hole.net/guides/github/how-to-fork-rebase/)
+
+ - (Optional fun) keep to the theme of Star Trek/black holes/gravity.
+