awx/README.md

[![Devel Requirements Status](https://requires.io/github/ansible/awx/requirements.svg?branch=devel)](https://requires.io/github/ansible/awx/requirements/?branch=devel)

AWX
===

AWX provides a web-based user interface, REST API, and task engine built on top of [Ansible](https://github.com/ansible/ansible). It is the upstream project for [Tower](https://www.ansible.com/tower), a commercial derivative of AWX.  

To install AWX, please view the [Install guide](./INSTALL.md).

To learn more about using AWX, and Tower, view the [Tower docs site](http://docs.ansible.com/ansible-tower/index.html).

Contributing
------------

- Refer to the [Contributing guide](./CONTRIBUTING.md) to get started developing, testing, and building AWX.
- All code submissions are done through pull requests against the `devel` branch.
- All contributors must use git commit --signoff for any commit to be merged, and agree that usage of --signoff constitutes agreement with the terms of [DCO 1.1](./DCO_1_1.md)
- Take care to make sure no merge commits are in the submission, and use `git rebase` vs `git merge` for this reason.
- If submitting a large code change, it's a good idea to join the `#ansible-awx` channel on irc.freenode.net, and talk about what you would like to do or add first. This not only helps everyone know what's going on, it also helps save time and effort, if the community decides some changes are needed.

Reporting Issues
----------------

If you're experiencing a problem, we encourage you to open an issue, and share your feedback. But before opening a new issue, we ask that you please take a look at our [Issues guide](./ISSUES.md).

Code of Conduct
---------------

We ask all of our community members and contributors to adhere to the [Ansible code of conduct](http://docs.ansible.com/ansible/latest/community#community-code-of-conduct). If you have questions, or need assistance, please reach out to our community team at [codeofconduct@ansible.com](mailto:codeofconduct@ansible.com)   

Get Involved
------------

We welcome your feedback and ideas. Here's how to reach us:

- Join the `#ansible-awx` channel on irc.freenode.net
- Join the [mailing list](https://groups.google.com/forum/#!forum/awx-project) 
- [Open an Issue](https://github.com/ansible/awx/issues)

License
-------

[Apache v2](./LICENSE.md)
Development documentation updates * Brand new CONTRIBUTING doc * Initial INSTALL doc * Update README with accurate details * Update UI README to purge Tower mentions * Updating setup.cfg to omit some directories that cause noise 2017-08-09 22:54:58 +03:00			`[![Devel Requirements Status](https://requires.io/github/ansible/awx/requirements.svg?branch=devel)](https://requires.io/github/ansible/awx/requirements/?branch=devel)`
Add requires.io badge and remove out of date info 2016-01-19 19:50:44 +03:00
Development documentation updates * Brand new CONTRIBUTING doc * Initial INSTALL doc * Update README with accurate details * Update UI README to purge Tower mentions * Updating setup.cfg to omit some directories that cause noise 2017-08-09 22:54:58 +03:00			`AWX`
Updates CONTRIBUTING and README 2017-08-29 18:11:51 +03:00			`===`
Added main readme, work on contributing doc. 2013-06-23 19:50:46 +04:00
Updates CONTRIBUTING and README 2017-08-29 18:11:51 +03:00			`AWX provides a web-based user interface, REST API, and task engine built on top of [Ansible](https://github.com/ansible/ansible). It is the upstream project for [Tower](https://www.ansible.com/tower), a commercial derivative of AWX.`
Added main readme, work on contributing doc. 2013-06-23 19:50:46 +04:00
Updates CONTRIBUTING and README 2017-08-29 18:11:51 +03:00			`To install AWX, please view the [Install guide](./INSTALL.md).`
Added main readme, work on contributing doc. 2013-06-23 19:50:46 +04:00
Updates CONTRIBUTING and README 2017-08-29 18:11:51 +03:00			`To learn more about using AWX, and Tower, view the [Tower docs site](http://docs.ansible.com/ansible-tower/index.html).`
Added main readme, work on contributing doc. 2013-06-23 19:50:46 +04:00
Updates CONTRIBUTING and README 2017-08-29 18:11:51 +03:00			`Contributing`
			`------------`

			`- Refer to the [Contributing guide](./CONTRIBUTING.md) to get started developing, testing, and building AWX.`
			- All code submissions are done through pull requests against the `devel` branch.
			`- All contributors must use git commit --signoff for any commit to be merged, and agree that usage of --signoff constitutes agreement with the terms of [DCO 1.1](./DCO_1_1.md)`
			- Take care to make sure no merge commits are in the submission, and use `git rebase` vs `git merge` for this reason.
			- If submitting a large code change, it's a good idea to join the `#ansible-awx` channel on irc.freenode.net, and talk about what you would like to do or add first. This not only helps everyone know what's going on, it also helps save time and effort, if the community decides some changes are needed.

			`Reporting Issues`
			`----------------`

			`If you're experiencing a problem, we encourage you to open an issue, and share your feedback. But before opening a new issue, we ask that you please take a look at our [Issues guide](./ISSUES.md).`

			`Code of Conduct`
			`---------------`

			`We ask all of our community members and contributors to adhere to the [Ansible code of conduct](http://docs.ansible.com/ansible/latest/community#community-code-of-conduct). If you have questions, or need assistance, please reach out to our community team at [codeofconduct@ansible.com](mailto:codeofconduct@ansible.com)`

			`Get Involved`
			`------------`

			`We welcome your feedback and ideas. Here's how to reach us:`

			- Join the `#ansible-awx` channel on irc.freenode.net
			`- Join the [mailing list](https://groups.google.com/forum/#!forum/awx-project)`
			`- [Open an Issue](https://github.com/ansible/awx/issues)`

			`License`
			`-------`

			`[Apache v2](./LICENSE.md)`
Update README.md 2013-07-31 18:20:46 +04:00