Add FAQ.

diff --git a/sphinx/_templates/layout.html b/sphinx/_templates/layout.html
index 43d9ebb47a454d21d3e72d164815af705e301e6e..3374093992e8495848bc73c1ec0adcbeed14a168 100644 (file)
--- a/sphinx/_templates/layout.html
+++ b/sphinx/_templates/layout.html
@@ -7,7 +7,8 @@
 {% block rootrellink %}
   <li><a href="http://www.debian.org" target="_blank">Debian</a> |&nbsp;</li>
   <li><a href="{{ pathto('index') }}">Neuroscience Repository</a> &raquo;</li>
-  <li><a href="{{ pathto('pkgs') }}">Package list</a></li>
+  <li><a href="{{ pathto('pkgs') }}">Package list</a> &raquo;</li>
+  <li><a href="{{ pathto('faq') }}">FAQ</a></li>
 {% endblock %}
 
 {% block sidebar1 %}{% endblock %}

diff --git a/sphinx/faq.rst b/sphinx/faq.rst
new file mode 100644 (file)
index 0000000..508b8af
--- /dev/null
+++ b/sphinx/faq.rst
@@ -0,0 +1,52 @@
+.. -*- mode: rst; fill-column: 78 -*-
+.. ex: set sts=4 ts=4 sw=4 et tw=79:
+  ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ###
+  #
+  #   See COPYING file distributed along with the PyMVPA package for the
+  #   copyright and license terms.
+  #
+  ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ###
+
+
+.. _faq:
+
+**************************
+Frequently Asked Questions
+**************************
+
+
+Why is NeuroDebian not a Pure Blend?
+------------------------------------
+
+  Because the is not need for it to become one. NeuroDebian's goal is to
+  provide software for neuroscientists using the Debian operating system, and
+  therefore the ultimate goal is to get all relevant software **into Debian**.
+
+  However, various reasons exist that prevent a particular software from
+  entering Debian. Some are temporary, i.e. a package is already useable, but
+  some technical bits do not meet Debian's standard yet, or a licensing issue
+  needs to be resolved first. For some software the licensing is so restrictive
+  that it cannot be distributed by Debian, and hence cannot even go into its
+  *non-free* branch. Unfortunately, sometimes these issues cannot be solved to
+  a degree that is acceptable for Debian. For some other packages Debian itself
+  is not ready yet, e.g. huge data packages with neuroscience data (:ref:`with
+  sometimes over 1GB <pkg_fsl-first-data>`) 
+
+  NeuroDebian aims to be a platform that provides a staging area for
+  neuroscience software packages on their way into Debian. All packages are
+  properly registered with the relevant `Debian Pure Blends`_, e.g.
+  `Debian-Science Cognitive Neuroscience`_ or `Debian-Med Imaging`_. Inside
+  Debian these efforts already provide a suitable framework for this purpose,
+  and hence there is now need to establish yet another one.
+
+.. _Debian Pure Blends: http://wiki.debian.org/DebianPureBlends
+.. _Debian-Science Cognitive Neuroscience: http://blends.alioth.debian.org/science/tasks/neuroscience-cognitive
+.. _Debian-Med Imaging: http://debian-med.alioth.debian.org/tasks/imaging
+
+
+How to create a mirror of the repository?
+------------------------------------
+
+  If you are interested in sponsoring storage space and bandwidth for another
+  mirror, please contact michael.hanke@gmail.com.
+

diff --git a/sphinx/index.rst b/sphinx/index.rst
index 5e149fcc0bb5ca8a82b7c9f5dea8520a665c623d..51e33d3c2dbd300672992d6edfa089437ed59799 100644 (file)
--- a/sphinx/index.rst
+++ b/sphinx/index.rst
@@ -36,8 +36,7 @@ releases and repository mirrors:
 .. include:: sources_lists
 
 .. note::
-  If you are interested in sponsoring storage space and bandwidth for another
-  mirror, please contact michael.hanke@gmail.com.
+  If your are interested in mirroring the repository, please see the :ref:`faq`.
 
 Once this is done, you have to update the package index. Use your favorite
 package manager, e.g. synaptic, adept, or whatever you like. In the terminal