spacemacs/COMMUNITY.org

/This document is under construction, the final version will be released in the
version 0.106.0 of Spacemacs/

* Philosophy
** For Contributors
- This community is a community of hackers based on meritocracy and volunteering.
Hackers strive for excellent to make the world a better place, so does the
Spacemacs community.
- Be good in what you bring to the project be it code, documentation, typo
fixes, art, humor, ideas, project management, web design, assurance quality,
mentorship, you name it! We like to award achievements to people making a
difference in a wide variety of domains and occasions, [[file:./doc/DOCUMENTATION.org#specials][see it for yourself]].
Why not you? Make it happen, make history!
- Think you are not good enough? Find support and mentors by chatting on Gitter
with fellow Spacemacs users or just open an issue on GitHub, you will find help
to fulfil your desire of contribution. We welcome anyone with good intentions.
- In a nutshell: Be good, positive and/or with good intentions and focused on
the project.
** For Users
- Any question related to the project is welcomed and encouraged, the worst
thing that can happen is that we redirect you to the documentation.
- The majority of the interactions with the community happens on GitHub via
issues and on Gitter via the official Spacemacs channel. There is also an active
official twitter account =spacemacs=.
- Any opinion on the project is valorized given it is constructive.

* Moderation
We want the community to be judged based on its moderation actions instead of
telling people how to behave. The golden rules of the community are to have good
intentions and stay focused on the project, for anything else that requires
moderation any future user or contributor can refer to this section to know
about our past moderation actions. So readers won't find any example or
definition of what collaborators judge offending or outrageous, instead they
will find at the end of this section a log of all major moderation actions taken
by the collaborators since the beginning of the project which started officially
in August 2014. It should allow you to decided whether or not you want to be
part of this community. If you are not convinced then be assured that the only
evil part in Spacemacs is the evil mode :-)
** Guidelines
These guidelines apply to all collaborators of the project, namely @syl20bnr,
@TheBB and @StreakyCobra.
*** People
- Collaborators cannot ban any GitHub user from the repository but they can ban
users from the official Gitter channel.
- A user can be banned if and only if all the collaborators agree to do so.
- The reasons of the ban are mentioned in the moderation actions log (see below).
*** Issues
- Issues can be locked if their contents are judged _inappropriate_, _offending_
or if they deviate _dangerously_ from the focus which is the project.
*** Pull requests and Commmits
- Collaborators can push to the repository without making a PR.
- PR can be rejected. Rejected PR always go with a reason explicitly written
when closing the PR.
- Commits can be reverted if they compromise the stability of the project. The
reason is contained in the commit comments.
- Pull request are also issues, thus issue guidelines also apply to pull
requests.
*** Messages
- Only the form of a message can be edited, not its meaning, except if this
meaning is _outrageous_.
- Moderators can add information to a message to improve its accuracy without
altering its meaning,
- Any edition of a message is logged in the =edits log= located at the end of
the edited message with the following format:
#+BEGIN_EXAMPLE
[EDIT: [@moderator] action (reason: xxx)
#+END_EXAMPLE
- The reason is added only when needed (for instance we won't add a reason for
formatting edits)
** Interpretation
Words used in these guidelines like _inappropriate_, _offending_, _dangerously_
and _outrageous_ are used without any explanation on purpose, their meanings and
interpretations are left solely to the discretion of the collaborators who are
educated persons and highly trusted members of the community happy to help it to
grow in a sane manner.
** Collaborators privacy
Life and actions of collaborators outside of the project (i.e. outside of the
Spacemacs GitHub repository, official Spacemacs Gitter channels and Twitter
official Spacemacs account timeline) are completely detached from their
activities and roles in the project. They are free to express any opinion on the
project or any other subjects and those opinions cannot be used to compromise
their roles in the project as long as they follow the moderation guidelines with
good intentions.
** Maintainer
- The maintainer @syl20bnr as a BDFL is free to demote a collaborator in extreme
situations.
- When there is no consensus on a subject, the BDFL can decide to impose his
view on the subject.
** Log
For transparency and future reference any major moderation actions are recorded
here. As of Sunday, April 10th 2016, 5747 issues have been opened and 2 major
moderation actions have been taken:
| Date       | Moderator | Action | Issue | Reason                                                          |
|------------+-----------+--------+-------+-----------------------------------------------------------------|
| 2016/01/27 | syl20bnr  | lock   | #3484 | comments judged to be offending towards the Spacemacs community |
| 2016/01/27 | syl20bnr  | unlock | #3484 | let's make it happen, i.e. this document                        |