From 6ac1575fef13ce635cebb7da235c7d66e601de7c Mon Sep 17 00:00:00 2001
From: Michael Hanke <michael.hanke@gmail.com>
Date: Wed, 19 Aug 2009 16:27:02 -0400
Subject: [PATCH] Add FAQ.

---
 sphinx/_templates/layout.html |  3 +-
 sphinx/faq.rst                | 52 +++++++++++++++++++++++++++++++++++
 sphinx/index.rst              |  3 +-
 3 files changed, 55 insertions(+), 3 deletions(-)
 create mode 100644 sphinx/faq.rst

diff --git a/sphinx/_templates/layout.html b/sphinx/_templates/layout.html
index 43d9ebb..3374093 100644
--- 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
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 5e149fc..51e33d3 100644
--- 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
-- 
2.39.2