Reorganise user documentation.

Jürgen Knödlseder
1 parent c898908b
Showing 6 changed files with 30 additions and 6 deletions
doc/source/_templates/index.html
doc/source/_themes/sphinx13/layout.html
doc/source/about.rst
doc/source/contents.rst
doc/source/help.rst
doc/source/issues.rst
@@ -25,6 +25,12 @@ By making use of the GammaLib multi-instrument capabilities, ctools
 supports the joint analysis of CTA (or any IACT providing data in the
 CTA format), Fermi/LAT and COMPTEL data. {%endtrans%}</p>
+<p>{%trans%} ctools are developed by a team of enthousiastic gamma-ray
+astronomers with support from engineers. We regularily organise
+<a href=https://cta-redmine.irap.omp.eu/projects/ctools/wiki/Coding_sprints>coding sprints</a>
+where key developers but also newcomers meet to discuss the developments 
+and next steps, and advance with the coding of the software. {%endtrans%}</p>
+
 <p>{%trans%} ctools is free software distributed under the
 <a href="http://www.gnu.org/licenses/gpl.html">GNU GPL license version 3</a> {%endtrans%}</p>
@@ -52,5 +58,6 @@ CTA format), Fermi/LAT and COMPTEL data. {%endtrans%}&lt;/p&gt;
 <h2 style="margin-bottom: 0">{%trans%}Links{%endtrans%}</h2>
 <ul>
-	<li><a href="https://cta-redmine.irap.omp.eu/projects/ctools">Developer's pages</a>{% endblock %}</li>
+	<li><a href="https://cta-redmine.irap.omp.eu/projects/ctools">Developer's pages</a></li>
+	<li><a href="https://www.openhub.net/p/ctools_">ctools on Open HUB</a>{% endblock %}</li>
 </ul>
@@ -68,15 +68,15 @@
 <div class="pageheader">
   <ul>
     <li><a href="{{ pathto('about') }}">About</a></li>
-    <li><a href="{{ pathto('index') }}">Home</a></li>
     <li><a href="{{ pathto('download') }}">Download</a></li>
     <li><a href="{{ pathto('contents') }}">Documentation</a></li>
     <li><a href="{{ pathto('develop') }}">Develop</a></li>
+    <li><a href="{{ pathto('help') }}">Help</a></li>
   </ul>
   <div>
     <a href="{{ pathto('index') }}">
       <div class=banner_part>
-      <img src="{{ pathto('_static/logo.png', 1) }}" height="64" alt="SPHINX" />
+      <img src="{{ pathto('_static/logo.png', 1) }}" height="64" alt="ctools" />
       </div>
 	  <div class=banner_part></div>
 	  <div class=banner_part></div>
@@ -27,6 +27,12 @@ By making use of the GammaLib multi-instrument capabilities, ctools
 supports the joint analysis of CTA (or any IACT providing data in the 
 CTA format), Fermi/LAT and COMPTEL data.
+ctools are developed by a team of enthousiastic gamma-ray astronomers with
+support from engineers. We regularily organise
+`coding sprints <https://cta-redmine.irap.omp.eu/projects/ctools/wiki/Coding_sprints>`_
+where key developers but also newcomers meet to discuss the developments 
+and next steps, and advance with the coding of the software.
+
 Acknowledging or citing ctools
 ------------------------------
@@ -15,4 +15,5 @@ Documentation
    reference_manual/index
    faq
    issues
-   develop
 \ No newline at end of file
+   develop
+   help
 \ No newline at end of file
+.. _help:
+
+Getting Help
+============
+
+Any questions, bug reports, or suggested enhancements related to
+ctools should be submitted via the
+`issue tracker <https://cta-redmine.irap.omp.eu/projects/ctools/issues/new>`_
+or the
+`mailing list <mailto:ctools@irap.omp.eu>`_.
 \ No newline at end of file
@@ -8,7 +8,7 @@ Below you will find a list of known issues.
 **Installation issues**
 - :ref:`Certificate problem when cloning from Git <issue_ssl>`
-- :ref:`Python unit test fail on El Capitan <issue_elcapitan>`
+- :ref:`Python unit test fails on El Capitan <issue_elcapitan>`
 **Analysis issues**
@@ -40,7 +40,7 @@ Installation issues
 .. _issue_elcapitan:
-.. topic:: Python unit test fail on El Capitan
+.. topic:: Python unit test fails on El Capitan
     On Mac OS X 10.11 (El Capitan) the Python unit tests fail when ctools 
     are not installed due to the way the ``DYLD_LIBRARY_PATH`` environment