From: Alex Waite Date: Wed, 2 Jan 2013 13:14:50 +0000 (+0100) Subject: Reorder the FAQ to reflect (what I imagine) is a more likely order of topics/prioriti... X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=bd0e750aa7e844a1cfa62f1fb653e3ac219d989d;p=neurodebian.git Reorder the FAQ to reflect (what I imagine) is a more likely order of topics/priorities for a newcomer. --- diff --git a/sphinx/faq.rst b/sphinx/faq.rst index 814a7bb..5bb862d 100644 --- a/sphinx/faq.rst +++ b/sphinx/faq.rst @@ -26,65 +26,6 @@ Frequently Asked Questions environment with as many additional relevant software as possible. - Why is NeuroDebian not a Pure Blend? - This is in the works, but... - - There is no need for it to become one, as the existing Debian Pure Blends - already offer the desired functionality *within* Debian. Similar to Pure - Blends, 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 standards (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 `). - - 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 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. - - .. _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 - - - 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 `, 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? - In short: When it is ready. The longer answer is that there is nothing - special to packages in NeuroDebian in comparison to packages conducted - elsewhere. Packaging efforts are announced to Debian via ITPs_ and the - packaging itself is available in some version control system -- typically in - the Git repositories of the `pkg-exppsy group on Debian's Alioth server`_, or - another VCS, or on http://mentors.debian.net. - - The only difference is that a particular package becomes available through the - NeuroDebian repository before it has passed all checks for compliance with - Debian's standards. But even after a package becomes part of Debian the - NeuroDebian repository continues to provide binary packages of new versions - for a certain set of Debian and Ubuntu releases (aka backports). - - .. _ITPs: http://www.debian.org/devel/wnpp - .. _pkg-exppsy group on Debian's Alioth server: http://alioth.debian.org/projects/pkg-exppsy/ - - Debian, Debian, Debian -- What about Ubuntu? NeuroDebian offers backported binary packages for recent Ubuntu releases whenever possible. However, since Ubuntu (like many other derivatives) uses @@ -100,12 +41,6 @@ Frequently Asked Questions releases. - How to create a mirror of the repository? - The NeuroDebian repository can be mirrored with rsync. If you are interested - in sponsoring storage space and bandwidth for another mirror, please - `contact us `_. - - How do I get a new neuroscience-related FOSS into (Neuro)Debian? The goal of NeuroDebian is to package neuroscience software for Debian. Hence getting software into NeuroDebian means trying to get it into Debian. There are @@ -131,6 +66,31 @@ Frequently Asked Questions packages in NeuroDebian are provided free of charge and under the licensing terms of the original developers. + + When does a package migrate from NeuroDebian into Debian proper? + In short: When it is ready. The longer answer is that there is nothing + special to packages in NeuroDebian in comparison to packages conducted + elsewhere. Packaging efforts are announced to Debian via ITPs_ and the + packaging itself is available in some version control system -- typically in + the Git repositories of the `pkg-exppsy group on Debian's Alioth server`_, or + another VCS, or on http://mentors.debian.net. + + The only difference is that a particular package becomes available through the + NeuroDebian repository before it has passed all checks for compliance with + Debian's standards. But even after a package becomes part of Debian the + NeuroDebian repository continues to provide binary packages of new versions + for a certain set of Debian and Ubuntu releases (aka backports). + + .. _ITPs: http://www.debian.org/devel/wnpp + .. _pkg-exppsy group on Debian's Alioth server: http://alioth.debian.org/projects/pkg-exppsy/ + + + How to create a mirror of the repository? + The NeuroDebian repository can be mirrored with rsync. If you are interested + in sponsoring storage space and bandwidth for another mirror, please + `contact us `_. + + .. _sec_pkg_authentication: What means "The following signatures couldn't be verified..."? @@ -164,6 +124,47 @@ Frequently Asked Questions as root or use sudo). + Why is NeuroDebian not a Pure Blend? + This is in the works, but... + + There is no need for it to become one, as the existing Debian Pure Blends + already offer the desired functionality *within* Debian. Similar to Pure + Blends, 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 standards (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 `). + + 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 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. + + .. _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 + + + 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 `, 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! + + How can I cite NeuroDebian? Please cite the following paper: