COMMUNITY.org: Formatting

This commit is contained in:
syl20bnr 2016-04-11 22:07:41 -04:00
parent 23168dbc84
commit 9f4928efe1
1 changed files with 27 additions and 26 deletions

View File

@ -4,24 +4,25 @@ 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.
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!
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.
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.
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.
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=.
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
@ -41,32 +42,32 @@ 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.
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.
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.
when closing the PR.
- Commits can be reverted if they compromise the stability of the project. The
reason is contained in the commit comments.
reason is contained in the commit comments.
- Pull request are also issues, thus issue guidelines also apply to pull
requests.
requests.
*** Messages
- Only the form of a message can be edited, not its meaning, except if this
meaning is _outrageous_.
meaning is _outrageous_.
- Moderators can add information to a message to improve its accuracy without
altering its meaning,
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 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)
formatting edits)
** Interpretation
Words used in these guidelines like _inappropriate_, _offending_, _dangerously_
and _outrageous_ are used without any explanation on purpose, their meanings and
@ -83,9 +84,9 @@ 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.
situations.
- When there is no consensus on a subject, the BDFL can decide to impose his
view on the subject.
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