From: Michael Hanke <michael.hanke@gmail.com>
Date: Tue, 25 Sep 2012 14:33:02 +0000 (+0200)
Subject: More polish.
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=8a7467a5c3785a813b74edb2249c6d0ec2a98a73;p=neurodebian.git

More polish.
---

diff --git a/sphinx/faq.rst b/sphinx/faq.rst
index 2c736ae..b91027c 100644
--- a/sphinx/faq.rst
+++ b/sphinx/faq.rst
@@ -21,11 +21,13 @@ Why NeuroDebian?
 
 
 Why is NeuroDebian not a Pure Blend?
-  Because 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**.
+  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
diff --git a/sphinx/index.rst b/sphinx/index.rst
index 424e135..ca431c9 100644
--- a/sphinx/index.rst
+++ b/sphinx/index.rst
@@ -43,7 +43,7 @@ Learn more about NeuroDebian, the goals of this project, and help us |spread|!
 Get NeuroDebian
 ===============
 
-Choose on which operating system you want to run NeuroDebian, and select a
+First select what kind of operating system you are using, and then choose a
 download server close to you:
 
 .. include:: sources_lists
@@ -52,8 +52,10 @@ download server close to you:
 
   <div id="reposetup" style="display:none">
 
-To enable NeuroDebian on your system, simply copy and paste the following
-commands into a terminal window:
+You can enable NeuroDebian on your system by simply copying and pasting the
+following two commands into a terminal window. This will add the NeuroDebian
+repository to your native package management system, and you will be able to
+install neuroscience software the same way as any other package.
 
 .. raw:: html
 
@@ -61,13 +63,15 @@ commands into a terminal window:
   After selecting a release the setup code will be shown here.
   </pre>
 
-Once this is done, you have to update the package index and you are ready to
-install packages. Use your favorite package manager, e.g. synaptic, adept. In
-the terminal you can use :command:`apt-get`::
+Now you can update the package index and you are ready to install packages.
+Of course you can use your favorite package manager (e.g. synaptic, adept)
+for this. In the terminal you can use :command:`apt-get`::
 
   sudo apt-get update
   sudo apt-get install mricron
 
+You are ready to go -- enjoy NeuroDebian!
+
 .. note::
 
   Not every package is available for all distributions/releases. For information
@@ -80,13 +84,13 @@ the terminal you can use :command:`apt-get`::
 
   <div id="vmsetup" style="display:none">
 
-For all non-Debian operating systems the recommended way to deploy NeuroDebian
-is a `virtual appliance`_. On all modern hardware (built within the last 3-4
-years) a virtual appliance is a convenient solution to run NeuroDebian
-simultaneously with the primary operating system -- without noticable
-performance loss.
+For all non-Debian operating systems we recommend to deploy NeuroDebian as a
+`virtual appliance`_ (virtual machine). On all modern hardware (built within
+the last 3-4 years) a virtual appliance is a convenient solution to run
+NeuroDebian simultaneously with the primary operating system -- without
+noticeable performance loss. To start using NeuroDebian:
 
-1. Install NeuroDebian by first downloading this image file:
+1. Download this image file:
 
 .. raw:: html
 
@@ -94,14 +98,15 @@ performance loss.
   <a href="http://neuro.debian.net/debian/vm/">NeuroDebian images</a>
   </div>
 
-2. Once downloaded, import this image into your VirtualBox_ installation. If you
-   do not have VirtualBox_ installed yet, visit the `VirtualBox download page
-   <http://www.virtualbox.org/wiki/Downloads>`_ that provides installers for
-   Windows, Linux, Mac and Solaris.
+2. Import this image into VirtualBox_. If you do not have VirtualBox_
+   installed yet, visit the `VirtualBox download page
+   <http://www.virtualbox.org/wiki/Downloads>`_ and get an installer for your
+   system (installers for Windows, Linux, Mac and Solaris are available).
+
+3. Finish the configuration by following :ref:`the instructions on setting up
+   the virtual appliance <chap_vm>`.
 
-3. Please read :ref:`the detailed instructions on setting up the virtual
-   appliance <chap_vm>` to complete the configuration of your NeuroDebian
-   environment.
+You are ready to go -- enjoy NeuroDebian!
 
 .. note::
 
diff --git a/sphinx/publications.rst b/sphinx/publications.rst
index 3473232..b3469db 100644
--- a/sphinx/publications.rst
+++ b/sphinx/publications.rst
@@ -5,6 +5,9 @@
 Publications
 ************
 
+This is a list of publication from the NeuroDebian team on various
+NeuroDebian-related topics:
+
 Hanke, M. (2012). `Share your tools! But fear the wombat! Seriously.
 <http://neuro.debian.net/_files/Hanke_FearTheWombat_Brainhack2012.pdf>`_  *Talk
 given at* `Brainhack <http://brainhack.org/2012/04/06/brainhack-2012-unconference>`_ 2012 at the