diff --git a/content/common/kwant.css b/content/common/kwant.css
index 876d40a78fc5a79829aa42f4924b0d958a9b3d7a..e5c2a453e9ad5b24fc1f06491a0d8251746d5b57 100644
--- a/content/common/kwant.css
+++ b/content/common/kwant.css
@@ -61,7 +61,7 @@ ul.navigation li{
margin: 0 1em;
}
-.hidden_structure h1, h2, h3, h4, h5, h6 {
+.hidden_structure {
display: none;
}
diff --git a/content/community.txt b/content/community.txt
index 48e43d0e12042b056023ec4706ed709fcb74681c..5feedbae8fddcd4086a3e38970222fcc73710d4f 100644
--- a/content/community.txt
+++ b/content/community.txt
@@ -1,11 +1,112 @@
-Kwant mailing list
-==================
+Getting help, contributing and reporting problems
+=================================================
-The mailing list kwant-discuss@kwant-project.org serves as the main platform
-for discussion of various aspects of Kwant: reporting bugs, asking questions,
-and discussing furhter development. You can sign up to the mailing list at its
-`info page <https://mailman-mail5.webfaction.com/listinfo/kwant-discuss>`_. The
-mailing list archives are available through `gmane
-<http://gmane.org/gmane.comp.python.kwant.user>`_.
+Mailing list
+------------
-New releases of Kwant are announced through kwant-announce@kwant-project.org.
+The mailing list is (meant to become) the main communication platform for
+anything related to Kwant: asking questions, reporting bugs, and discussing
+further development. You can use it in various ways:
+
+- `Subscribe <https://mailman-mail5.webfaction.com/listinfo/kwant-discuss>`_ and
+ use it along with your regular email. (You can unsubscribe at any moment.)
+
+- Follow through the `Gmane web interface
+ <http://news.gmane.org/gmane.comp.science.kwant.user>`_. It is both possible
+ to write new messages (action: post) and to reply (action: followup).
+
+- .. raw:: html
+
+ <p><form id="searchgmane" method="get" action="http://search.gmane.org/">
+ <input type="text" name="query" />
+ <input type="hidden" name="group" value="gmane.comp.science.kwant.user" />
+ <input type="submit" value="Search the Kwant mailing list" />
+ </form></p>
+
+- Send a message directly to kwant-discuss@kwant-project.org. (If you are not
+ subscribed, it is not guaranteed that any replies will reach you by email.)
+
+
+Reporting bugs
+--------------
+
+If you encounter a problem with Kwant, first try to reproduce it with as simple
+a system as possible. Double-check with the documentation that what you
+observe is actually a bug in Kwant. If you think it is, please check whether
+the problem is already known by searching the mailing list.
+
+If the problem is not known yet, please send a bug report to the mailing list.
+A report should contain:
+
+* The versions of software you are using (Kwant, Python, operating system, etc.)
+
+* A description of the problem, i.e. what exactly goes wrong.
+
+* Enough information to reproduce the bug, preferably in the form of a simple
+ script.
+
+
+Contributing
+------------
+
+We see Kwant not just as a package with fixed functionality, but rather as a
+framework for implementing different physics-related algorithms using a common
+set of concepts and, if possible, a shared interface. We have designed it
+leaving room for growth, and plan to keep extending it.
+
+External contributions to Kwant are highly welcome. You can help to advance
+the project not only by writing code, but also by reporting bugs, and
+fixing/improving the documentation. A `mailing list
+</community.html>`_ is available for discussions.
+
+If you have some code that works well with Kwant, or extends it in some useful
+way, please consider sharing it. Any external contribution will be clearly
+marked as such, and relevant papers will be added to the list of `suggested
+acknowledgements </citing.html>`_. The complete development history is also
+made available through a `web interface <http://git.kwant-project.org/kwant>`_.
+If you plan to contribute, it is best to coordinate with us in advance either
+through the mailing list, or directly at authors@kwant-project.org for matters
+that you prefer to not discuss publicly.
+
+
+How to contribute
+.................
+
+We use the version control system `Git <http://git-scm.com/>`_ to coordinate the
+development of Kwant. If you are new to Git, we invite you to learn its basics.
+(There's a plethora of information available on the Web.) Kwant's Git
+repository contains not only the source code, but also all of the reference
+documentation and the tutorial.
+
+It is best to base your work on the latest version of Kwant::
+
+ git clone http://git.kwant-project.org/kwant
+
+Then you can modify the code, and build Kwant and the documentation as
+described in the `build instructions
+</docs/pre/install.html#building-and-installing-from-source>`_.
+
+Some things to keep in mind:
+
+* Please keep the code consistent by adhering to the prevailing naming and
+ formatting conventions. We generally follow the `"Style Guide for Python
+ Code" <http://www.python.org/dev/peps/pep-0008/>`_ For docstrings, we follow
+ `NumPy's "Docstring Standard"
+ <http://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt>`_ and
+ `Python's "Docstring Conventions"
+ <http://www.python.org/dev/peps/pep-0257/>`_.
+
+* Write tests for all the important functionality you add. Be sure not to
+ break existing tests.
+
+A useful trick for working on the source code is to build in-place so that there
+is no need to re-install after each change. This can be done with the following
+command ::
+
+ python setup.py build_ext -i
+
+The ``kwant`` subdirectory of the source distribution will be thus turned into
+a proper Python package that can be imported. To be able to import Kwant from
+within Python, one can either work in the root directory of the distribution
+(where the subdirectory ``kwant`` is located), or make a (symbolic) link from
+somewhere in the Python search path to the the package subdirectory.