2011-05-23 06:51:31 +00:00
|
|
|
=========
|
|
|
|
|
Community
|
|
|
|
|
=========
|
|
|
|
|
|
2011-06-22 05:04:07 +00:00
|
|
|
Join the Salt!
|
|
|
|
|
|
|
|
|
|
There are many ways to participate in and communicate with the Salt community.
|
|
|
|
|
|
|
|
|
|
Salt has an active IRC channel and a mailing list.
|
|
|
|
|
|
2011-06-25 07:32:50 +00:00
|
|
|
.. _community-mailing-list:
|
|
|
|
|
|
2011-06-22 05:04:07 +00:00
|
|
|
Mailing List
|
|
|
|
|
============
|
|
|
|
|
|
2011-06-25 07:32:50 +00:00
|
|
|
Join the `salt-users mailing list`_. It is the best place to ask questions
|
|
|
|
|
about Salt and see whats going on with Salt development! The Salt mailing list
|
|
|
|
|
is hosted by Google Groups. It is open to new members.
|
2011-06-22 05:04:07 +00:00
|
|
|
|
|
|
|
|
http://groups.google.com/group/salt-users
|
|
|
|
|
|
2011-06-25 07:32:50 +00:00
|
|
|
.. _`salt-users mailing list`: http://groups.google.com/group/salt-users
|
|
|
|
|
|
|
|
|
|
.. _community-irc:
|
2011-06-22 05:04:07 +00:00
|
|
|
|
|
|
|
|
IRC
|
|
|
|
|
===
|
|
|
|
|
|
2011-12-12 20:42:22 +00:00
|
|
|
The ``#salt`` IRC channel is hosted on the popular `Freenode`__ network. You
|
|
|
|
|
can use the `Freenode webchat client`__ right from your browser.
|
2011-06-22 05:04:07 +00:00
|
|
|
|
2012-03-19 12:07:08 +00:00
|
|
|
`Logs of the IRC channel activity`__ are being collected courtesy of Moritz Lenz.
|
|
|
|
|
|
2011-12-12 20:42:22 +00:00
|
|
|
.. __: http://freenode.net/irc_servers.shtml
|
|
|
|
|
.. __: http://webchat.freenode.net/?channels=salt&uio=Mj10cnVlJjk9dHJ1ZSYxMD10cnVl83
|
2012-03-19 12:07:08 +00:00
|
|
|
.. __: http://irclog.perlgeek.de/salt/
|
2011-06-25 07:32:50 +00:00
|
|
|
|
|
|
|
|
.. _community-github:
|
2011-06-22 05:04:07 +00:00
|
|
|
|
|
|
|
|
Follow on Github
|
|
|
|
|
================
|
|
|
|
|
|
2011-06-25 07:32:50 +00:00
|
|
|
The Salt code is developed via Github. Follow Salt for constant updates on what
|
2011-06-22 05:04:07 +00:00
|
|
|
is happening in Salt development:
|
|
|
|
|
|
2011-11-16 05:41:20 +00:00
|
|
|
|saltrepo|
|
2011-06-22 05:04:07 +00:00
|
|
|
|
2011-06-25 07:32:50 +00:00
|
|
|
.. _community-blog:
|
|
|
|
|
|
2011-06-22 05:04:07 +00:00
|
|
|
The Red45 Blog
|
|
|
|
|
==============
|
|
|
|
|
|
|
|
|
|
News and thoughts on Salt and related projects is often posted on Thomas' blog
|
2011-06-25 07:32:50 +00:00
|
|
|
`The Red45`_:
|
2011-06-22 05:04:07 +00:00
|
|
|
|
|
|
|
|
http://red45.wordpress.com/
|
|
|
|
|
|
2011-06-25 07:32:50 +00:00
|
|
|
.. _`The Red45`: http://red45.wordpress.com/
|
|
|
|
|
|
2012-03-18 23:29:24 +00:00
|
|
|
|
|
|
|
|
Example Salt States
|
|
|
|
|
===================
|
|
|
|
|
The official ``salt-states`` repository is:
|
|
|
|
|
https://github.com/saltstack/salt-states
|
|
|
|
|
|
2012-05-12 23:47:28 +00:00
|
|
|
A few examples of salt states from the community:
|
|
|
|
|
|
|
|
|
|
* https://github.com/blast-hardcheese/blast-salt-states
|
|
|
|
|
* https://github.com/kevingranade/kevingranade-salt-state
|
2012-03-18 23:29:24 +00:00
|
|
|
|
2011-06-25 07:32:50 +00:00
|
|
|
Follow on ohloh
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
https://www.ohloh.net/p/salt
|
|
|
|
|
|
2011-06-22 05:04:07 +00:00
|
|
|
Developing Salt
|
|
|
|
|
===============
|
|
|
|
|
|
2011-05-23 06:51:31 +00:00
|
|
|
If you want to help develop Salt there is a great need and your patches are
|
|
|
|
|
welcome!
|
|
|
|
|
|
|
|
|
|
To assist in Salt development, you can help in a number of ways.
|
|
|
|
|
|
|
|
|
|
Posting patches to the mailing list
|
2011-06-22 05:04:07 +00:00
|
|
|
-----------------------------------
|
2011-05-23 06:51:31 +00:00
|
|
|
|
|
|
|
|
If you have a patch for Salt, please format it via :command:`git format-patch` and
|
|
|
|
|
send it to the Salt users mailing list. This allows the patch to give you the
|
|
|
|
|
contributor the credit for your patch, and gives the Salt community an archive
|
|
|
|
|
of the patch and a place for discussion.
|
|
|
|
|
|
|
|
|
|
Setting a Github pull request
|
2011-06-22 05:04:07 +00:00
|
|
|
-----------------------------
|
2011-05-23 06:51:31 +00:00
|
|
|
|
|
|
|
|
This is probably the preferred method for contributions, simply create a Github
|
|
|
|
|
fork, commit your changes to the fork, and then open up a pull request.
|
|
|
|
|
|
2011-06-22 05:04:07 +00:00
|
|
|
Contributions Welcome!
|
|
|
|
|
----------------------
|
2011-05-23 06:51:31 +00:00
|
|
|
|
|
|
|
|
The goal here it to make contributions clear, make sure there is a trail for
|
|
|
|
|
where the code has come from, but most importantly, to give credit where credit
|
|
|
|
|
is due!
|
2011-06-22 05:04:07 +00:00
|
|
|
|
2012-05-12 20:34:32 +00:00
|
|
|
The `Open Comparison Contributing Docs`__ has some good suggestions and tips for
|
|
|
|
|
those who are looking forward to contribute.
|
|
|
|
|
|
|
|
|
|
.. __: http://opencomparison.readthedocs.org/en/latest/contributing.html
|
