summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorlouiz’ <louiz@louiz.org>2016-10-24 19:01:52 +0200
committerlouiz’ <louiz@louiz.org>2016-10-24 19:01:52 +0200
commit7b2215b8824295efaa77eea61a4d4eed4cd77ca3 (patch)
tree897fdc0208b655ccdabd07cc169ac4a96c8bf7da
parent5990a8bf8ae622f075a7e2a12b2f5ac0cab8713b (diff)
downloadbiboumi-7b2215b8824295efaa77eea61a4d4eed4cd77ca3.tar.gz
biboumi-7b2215b8824295efaa77eea61a4d4eed4cd77ca3.tar.bz2
biboumi-7b2215b8824295efaa77eea61a4d4eed4cd77ca3.tar.xz
biboumi-7b2215b8824295efaa77eea61a4d4eed4cd77ca3.zip
Add a CONTRIBUTING file
-rw-r--r--CONTRIBUTING.rst44
-rw-r--r--README.rst9
2 files changed, 46 insertions, 7 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
new file mode 100644
index 0000000..f80b4a9
--- /dev/null
+++ b/CONTRIBUTING.rst
@@ -0,0 +1,44 @@
+Contributing to biboumi
+=======================
+
+Biboumi’s main workplace is at https://lab.louiz.org/louiz/biboumi
+
+The repository is also mirrored on other websites, for example on github, but
+that’s mainly for the convenience of users.
+
+Before doing anything, you can come on the `XMPP chatroom`_ to discuss your
+changes, issues or ideas.
+
+Bug reports, feature requests
+-----------------------------
+To open a bug report, or a feature request, please do so on
+`our gitlab’s bug tracker`_.
+
+If the issue you’re reporting may have security implications, please select
+the “confidential” flag in your bug report.
+
+
+Code
+----
+To contribute code, you can do so using git: commit your changes on any
+publicly available git repository and communicate us its address. This
+can be done with a `gitlab merge request`_, or a `github pull request`_
+or just by sending a message into the `XMPP chatroom`_.
+
+
+Coding style
+------------
+Please try to follow the existing style:
+
+- Use only spaces, not tabs.
+- Curly brackets are on their own lines.
+- Use this-> everywhere it’s possible.
+- Don’t start class attributes with “m_” or similar.
+- Type names are in PascalCase.
+- Everything else is in snake_case.
+
+
+.. _our gitlab’s bug tracker: https://lab.louiz.org/louiz/biboumi/issues/new
+.. _gitlab merge request: https://lab.louiz.org/louiz/biboumi/merge_requests/new
+.. _github pull request: https://github.com/louiz/biboumi/pulls
+.. _XMPP chatroom: xmpp:biboumi@muc.poez.io
diff --git a/README.rst b/README.rst
index f1aefa3..fad4206 100644
--- a/README.rst
+++ b/README.rst
@@ -52,13 +52,7 @@ Contact/Support
* XMPP ChatRoom: biboumi@muc.poez.io
* Report a bug: https://lab.louiz.org/louiz/biboumi/issues/new
-To contribute, the preferred way is to commit your changes on some
-publicly-available git repository (a fork on gitlab or github or on your own
-repository) and to notify the developers with a ticket on the bug tracker,
-or a merge request on gitlab or a pull request on github.
-
-Optionally you can come discuss your changes on the XMPP chat room,
-beforehand.
+Also, see the `contributing`_ page.
Licence
@@ -71,3 +65,4 @@ Please read the COPYING file for details.
.. _INSTALL: INSTALL.rst
.. _the documentation: doc/biboumi.1.rst
+.. _contributing: CONTRIBUTING.rst