summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobyn Bergeron <robyn.bergeron@gmail.com>2016-08-10 12:27:32 -0700
committerGitHub <noreply@github.com>2016-08-10 12:27:32 -0700
commit90ae6e37616307d2ef5ab46d49f315ba3a314371 (patch)
tree0b709fe0b6985d2d6cc4b20e25dd590c3ee4225b
parent8ba7f008778850748a8b90ebec201f4c9ebb1b27 (diff)
downloadansible-modules-extras-robynbergeron-patch-1.tar.gz
Update GUIDELINES.mdrobynbergeron-patch-1
-rw-r--r--GUIDELINES.md15
1 files changed, 14 insertions, 1 deletions
diff --git a/GUIDELINES.md b/GUIDELINES.md
index 9e1e53cf..ddd918d4 100644
--- a/GUIDELINES.md
+++ b/GUIDELINES.md
@@ -15,11 +15,15 @@ When you contribute a new module to the ansible-modules-extras repository, you b
Maintainers of Ansible modules are expected to provide feedback, responses, or actions on pull requests or issues to the module(s) they maintain in a reasonably timely manner.
+It is also recommended that you occasionally revisit the [contribution guidelines](https://github.com/alikins/ansible-modules-extras/commit/c87795da5b0c95c67fea1608a5a2a4ec54cb3905), as they are continually refined. Occasionally, you may be requested to update your module to move it closer to the general accepted standard requirements; we hope for this to be infrequent, and will always be a request with a fair amount of lead time (ie: not by tomorrow!).
+
+Finally, following the ansible-devel mailing list can be a great way to participate in the broader Ansible community, and a place where you can influence the overall direction, quality, and goals of the Extras modules repository. If you're not on this relatively low-volume list, please join us here: https://groups.google.com/forum/#!forum/ansible-devel
+
The Ansible community hopes that you will find that maintaining your module is as rewarding for you as having the module is for the wider community.
***
-# Pull Requests and Issues
+# Pull Requests, Issues, and Workflow
## Pull Requests
@@ -33,6 +37,14 @@ Issues for modules, including bug reports, documentation bug reports, and featur
At this time, we do not have an automated process by which Issues are handled. If you are a maintainer of a specific module, it is recommended that you periodically search module issues for issues which mention your module's name (or some variation on that name), as well as setting an appropriate notification process for receiving notification of mentions of your GitHub ID.
+## PR Workflow
+
+Automated routing of pull requests is handled by a tool called [Ansibullbot](https://github.com/ansible/ansibullbot). (You could say that he moooo-ves things around.)
+
+Being moderately familiar with how the workflow behind the bot operates can be helpful to you, and -- should things go awry -- your feedback can be helpful to the folks that continually help Ansibullbot to evolve.
+
+A detailed explanation of the PR workflow can be seen here: https://github.com/ansible/community/blob/master/PR-FLOW.md
+
***
# Extras maintainers list
@@ -58,3 +70,4 @@ If you'd like to step down as a maintainer, please submit a PR to the maintainer
* Module maintainer list: https://github.com/ansible/ansibullbot/blob/master/MAINTAINERS-EXTRAS.txt
* Ansibullbot: https://github.com/ansible/ansibullbot
+* Triage / pull request workflow and information, including definitions for Labels in GitHub: https://github.com/ansible/community/blob/master/PR-FLOW.md