Skip to content

Commit 4690237

Browse files
committed
Add new policy guidelines for Extras
More to do here, but this is a start.
1 parent 2878344 commit 4690237

File tree

1 file changed

+22
-13
lines changed

1 file changed

+22
-13
lines changed

CONTRIBUTING.md

Lines changed: 22 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,37 @@
1-
Welcome To Ansible GitHub
2-
=========================
1+
Contributing to ansible-modules-extras
2+
======================================
33

4-
Hi! Nice to see you here!
4+
The Ansible Extras Modules are written and maintained by the Ansible community, according to the following contribution guidelines.
5+
6+
If you'd like to contribute code
7+
================================
8+
9+
Please see [this web page](http://docs.ansible.com/community.html) for information about the contribution process. Important license agreement information is also included on that page.
10+
11+
If you'd like to contribute code to an existing module
12+
======================================================
13+
Each module in Extras is maintained by the owner of that module; each module's owner is indicated in the documentation section of the module itself. Any pull request for a module that is given a +1 by the owner in the comments will be merged by the Ansible team.
14+
15+
If you'd like to contribute a new module
16+
========================================
17+
Ansible welcomes new modules. Please be certain that you've read the [module development guide and standards](http://docs.ansible.com/developing_modules.html) thoroughly before submitting your module.
18+
19+
Each new module requires two current module owners to approve a new module for inclusion. The Ansible community reviews new modules as often as possible, but please be patient; there are a lot of new module submissions in the pipeline, and it takes time to evaluate a new module for its adherence to module standards.
20+
21+
Once your module is accepted, you become responsible for maintenance of that module, which means responding to pull requests and issues in a reasonably timely manner.
522

623
If you'd like to ask a question
724
===============================
825

926
Please see [this web page ](http://docs.ansible.com/community.html) for community information, which includes pointers on how to ask questions on the [mailing lists](http://docs.ansible.com/community.html#mailing-list-information) and IRC.
1027

11-
The github issue tracker is not the best place for questions for various reasons, but both IRC and the mailing list are very helpful places for those things, and that page has the pointers to those.
12-
13-
If you'd like to contribute code
14-
================================
15-
16-
Please see [this web page](http://docs.ansible.com/community.html) for information about the contribution process. Important license agreement information is also included on that page.
28+
The Github issue tracker is not the best place for questions for various reasons, but both IRC and the mailing list are very helpful places for those things, and that page has the pointers to those.
1729

1830
If you'd like to file a bug
1931
===========================
2032

21-
I'd also read the community page above, but in particular, make sure you copy [this issue template](https://github.com/ansible/ansible/blob/devel/ISSUE_TEMPLATE.md) into your ticket description. We have a friendly neighborhood bot that will remind you if you forget :) This template helps us organize tickets faster and prevents asking some repeated questions, so it's very helpful to us and we appreciate your help with it.
33+
Read the community page above, but in particular, make sure you copy [this issue template](https://github.com/ansible/ansible/blob/devel/ISSUE_TEMPLATE.md) into your ticket description. We have a friendly neighborhood bot that will remind you if you forget :) This template helps us organize tickets faster and prevents asking some repeated questions, so it's very helpful to us and we appreciate your help with it.
2234

2335
Also please make sure you are testing on the latest released version of Ansible or the development branch.
2436

2537
Thanks!
26-
27-
28-

0 commit comments

Comments
 (0)