From acaa05c9ed0fabfa3f5f516d16c8b0918b8b3306 Mon Sep 17 00:00:00 2001
From: emmanuelle <emmanuelle.gouillart@nsup.org>
Date: Mon, 13 Feb 2012 23:16:09 +0100
Subject: [PATCH 1/2] User guide: first draft of "getting help"

---
 TASKS.txt                 | 2 ++
 doc/examples/README.txt   | 1 +
 doc/source/user_guide.txt | 1 +
 3 files changed, 4 insertions(+)

diff --git a/TASKS.txt b/TASKS.txt
index ad5e2f25..6c155bdf 100644
--- a/TASKS.txt
+++ b/TASKS.txt
@@ -1,5 +1,7 @@
  ..  role:: strike
 
+.. _howto_contribute:
+
 How to contribute to ``skimage``
 ======================================
 
diff --git a/doc/examples/README.txt b/doc/examples/README.txt
index 8a6c6bd5..d7169941 100644
--- a/doc/examples/README.txt
+++ b/doc/examples/README.txt
@@ -1,3 +1,4 @@
+.. _examples_gallery:
 
 General examples
 -------------------
diff --git a/doc/source/user_guide.txt b/doc/source/user_guide.txt
index b262581c..01344806 100644
--- a/doc/source/user_guide.txt
+++ b/doc/source/user_guide.txt
@@ -7,3 +7,4 @@ User Guide
    user_guide/data_types
    user_guide/plugins
    user_guide/tutorials
+   user_guide/getting_help

From facb37b157a25809029b1ff93e02e6ec29a2cf92 Mon Sep 17 00:00:00 2001
From: emmanuelle <emmanuelle.gouillart@nsup.org>
Date: Mon, 13 Feb 2012 23:19:47 +0100
Subject: [PATCH 2/2] getting_help file

---
 doc/source/user_guide/getting_help.txt | 56 ++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 doc/source/user_guide/getting_help.txt

diff --git a/doc/source/user_guide/getting_help.txt b/doc/source/user_guide/getting_help.txt
new file mode 100644
index 00000000..6dedb6f2
--- /dev/null
+++ b/doc/source/user_guide/getting_help.txt
@@ -0,0 +1,56 @@
+=================================
+Getting help on using ``skimage``
+=================================
+
+Besides the user guide, there exist other opportunities to get help on
+using ``skimage``.
+
+Examples gallery
+----------------
+
+The :ref:`examples_gallery` gallery provides graphical examples of
+typical image processing tasks. By a quick glance at the different
+thumbnails, the user may find an example close to a typical use case of
+interest. Each graphical example page displays an introductory paragraph,
+a figure, and the source code that generated the figure. Downloading the
+Python source code enables one to modify quickly the example into a case
+closer to one's image processing applications.
+
+Users are warmly encouraged to report on their use of ``skimage`` on the
+:ref:`mailing_list`, in order to propose more examples in the future.
+Contributing examples to the gallery can be done on github (see
+:ref:`howto_contribute`).
+
+Search field
+------------
+
+The ``quick search`` field located in the sidebar of the html
+documentation can be used to search for specific keywords (segmentation,
+rescaling, denoising, etc.).
+
+Docstrings
+----------
+
+Docstrings of ``skimage`` functions are formatted using `Numpy's
+documentation standard
+<https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt>`_,
+starting with a ``Parameters`` section for the arguments and a
+``Returns`` section for the objects returned by the function. Also, most
+functions include one or more examples.
+
+
+.. _mailing_list:
+
+Mailing-list
+------------
+
+The scikits-image mailing-list is scikits-image@googlegroups.com (users
+should join the `Google Group
+<http://groups.google.com/group/scikits-image>`_ before posting). This
+mailing-list is shared by users and developers, and it is the right
+place to ask any question about ``skimage``, or in general, image
+processing using Python.  Posting snippets of code with minimal examples
+ensures to get more relevant and focused answers. 
+
+We would love to hear from how you use ``skimage`` for your work on the
+mailing-list!