]> git.donarmstrong.com Git - neurodebian.git/blobdiff - sphinx/faq.rst
Adding the entry for upcoming talk
[neurodebian.git] / sphinx / faq.rst
index a30be4d891bdd0963abb813364619b6e526dd35a..4757ecad9b27e12ddf04a6b7c5721ab33d5238c1 100644 (file)
@@ -1,11 +1,5 @@
 .. -*- 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:
@@ -19,12 +13,12 @@ Why NeuroDebian?
 
   In the course of our own research endeavors |we| have joined forces to
   develop `PyMVPA -- a Python framework for multivariate pattern analysis of
-  neural data <http://www.pymvpa.org>`_.  To conveniently deployment PyMVPA for
+  neural data <http://www.pymvpa.org>`_.  To conveniently deploy PyMVPA for
   anyone using Debian-derived distributions this package repository was created
   initially.  Besides the PyMVPA_ project |we| collaborate with the `NiPy team
   <http://neuroimaging.scipy.org>`_ on various projects, such as NiBabel_ and
   NiPype_.  Quickly NeuroDebian_ became the ultimate integrated environment for
-  all these projects. We are now constantly working on enriching this
+  all these projects -- and we are constantly working on enriching this
   environment with as many additional relevant software as possible.
 
 
@@ -49,7 +43,7 @@ Why is NeuroDebian not a Pure Blend?
 
   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.
+  properly registered in 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 no need to establish yet another one.
@@ -59,6 +53,18 @@ Why is NeuroDebian not a Pure Blend?
 .. _Debian Med Imaging: http://debian-med.alioth.debian.org/tasks/imaging
 
 
+I want to help. How do I get involved?
+--------------------------------------
+
+  We always need people to help maintaining existing packages. If you need
+  some additional software packaged and you want to try it on your own, we would
+  be happy to mentor you. We also have a :ref:`list of ongoing and planned
+  projects <projects>`, each listing a number of tasks that need to be done.
+
+  If you found something you are interested in, please email the
+  neurodebian-devel_ mailing list and let us know about it. Thanks!
+
+
 When does a package migrate from NeuroDebian into Debian proper?
 ----------------------------------------------------------------
 
@@ -124,8 +130,8 @@ I have heard that some packages are non-free. Will you charge me for them?
 --------------------------------------------------------------------------
 
   No. The term :term:`non-free` refers to an archive section. NeuroDebian uses
-  exactly the same :ref:`archive sections as Debian proper
-  <http://www.debian.org/doc/debian-policy/ch-archive.html>`.  The *non-free*
+  exactly the same `archive sections as Debian proper
+  <http://www.debian.org/doc/debian-policy/ch-archive.html>`_.  The *non-free*
   section contains packages that have certain restrictions regarding **your
   freedom** to employ them for a particular purpose. In contrast, for packages
   in the *main* section your are completely free to do whatever and in whatever
@@ -133,6 +139,51 @@ I have heard that some packages are non-free. Will you charge me for them?
   packages in NeuroDebian are provided free of charge and under the licensing
   terms of the original developers.
 
+.. _sec_pkg_authentication:
+
+What means "The following signatures couldn't be verified..."?
+--------------------------------------------------------------
+
+When you start using this repository, you probably get warning messages
+like this::
+
+  The following signatures couldn't be verified because
+  the public key is not available.
+
+Or you will be asked questions like this over and over::
+
+  WARNING: The following packages cannot be authenticated!
+  ...
+  Install these packages without verification [y/N]?
+
+This is because your APT installation initially does not know the GPG
+key that is used to sign the release files of this repository. It is easy to
+make APT happy again. The simplest way is to install the ``neurodebian-keyring``
+package that is available from the NeuroDebian repository. Alternatively:
+
+1. Get the key. Either download the `repository key from here
+   <_static/neuro.debian.net.asc>`_
+   or fetch it from http://wwwkeys.pgp.net (2649A5A9).
+
+2. Now feed the key into APT by invoking::
+
+     apt-key add #file#
+
+   Where `#file#` has to be replaced with the location of the key file you just
+   downloaded. You need to have superuser-privileges to do this (either do it
+   as root or use sudo).
+
+
+How can I cite NeuroDebian?
+---------------------------
+
+Please cite the following paper:
+
+  Halchenko, Y. O. & Hanke, M. (2012). `Open is not enough. Let’s take the
+  next step: An integrated, community-driven computing platform for neuroscience
+  <http://www.frontiersin.org/Neuroinformatics/10.3389/fninf.2012.00022/full>`_.
+  *Frontiers in Neuroinformatics*, 6:22.
+
 
-.. include:: links_names.rst
-.. include:: substitutions.rst
+.. include:: link_names.txt
+.. include:: substitutions.txt