]> git.donarmstrong.com Git - neurodebian.git/blobdiff - artwork/brochure/brochure_debian-neurodebian.tex
And more
[neurodebian.git] / artwork / brochure / brochure_debian-neurodebian.tex
index e6d199c2718f975c873c29da447ef7797ef4e29b..8211ef718055e1cb3fa511cac03264eecda95e79 100644 (file)
@@ -18,7 +18,7 @@
 }
 
 \usepackage{enumitem}           % useful for control of listings
-\usepackage[compact,raggedleft]{titlesec}
+\usepackage[compact,raggedright]{titlesec}
 \usepackage{comment}
 
 \newcommand{\epigraph}[3]{\textit{#1}\linebreak \vspace{-1.5em} \begin{flushright}\hspace{5em}\ --\ #2\linebreak\small{#3} \end{flushright}}
 \end{center}
 \vspace{-1em}
 
-\section*{Debian project}
+\section*{Debian}
 was founded by Ian Murdock in August 1993 with the goal
 to create an easy to install and maintain non-commercial GNU/Linux
 distribution that would be able to effectively compete in the
 commercial market.  Since then Debian established itself as an
-independent and unique project driven by more than 3,000 of
-enthusiastic Debian developers and contributors all around the globe.
-Principles of \emph{do-ocracy} and democracy backed up by evolving open
-standards allowed Debian to deliver the comprehensive operating system largest not
-only in its coverage of integrated software, but also in the
+independent and unique project driven by more than 3000
+enthusiastic contributors all around the globe.
+Principles of \emph{do-ocracy} and democracy backed up by evolving transparent
+standards allowed Debian to deliver the most comprehensive operating system -- not
+only by amount of integrated software, but also by
 number of the supported hardware architectures.
 % Current installer of Debian has been translated more that to 60 languages.
 % (12 ???  officially supported architectures).
 % Well appreciated
-Acknowledged quality and openness of Debian made it the choice for
+Widely acknowledged quality and openness of Debian made it the foundation of choice for
 more than 120 derivative GNU/Linux distributions, such as Ubuntu and
 Mint.
 
 \subsection*{Debian is}
 \begin{description}[nolistsep,leftmargin=0.8em]
 \item[V\textnormal{ersatile}]\hfill\url{http://packages.debian.org}\\
-  Over 15,000 software products maintained to provide
-  a stable system for any field of application
+  Over 15000 software packages maintained by experts to provide
+  a stable system for \textit{any} field of application.
 \item[S\textnormal{ecure}]\hfill\url{http://www.debian.org/security}\\
-  Security updates guarantee virus-free safe operation
+  Security updates guarantee safe operation.
 %\item[S]table
 % \item[S\textnormal{imple}]\blank\\
 %   Single command is enough to install or upgrade single
 %   software or the entire system at once
 \item[O\textnormal{pen}]\hfill\url{http://www.debian.org/social_contract}\\
   All software is free and open-source (FOSS).\\
-  Debian project decisions are voted for in public
+  Debian is governed by public democratic processes.
 \item[P\textnormal{opular}]\hfill\url{http://www.debian.org/users}\\
-  Used by governments, companies, education institutions
+  Used by governments, companies, educational institutions
 \end{description}
 
 \begin{comment}
@@ -100,7 +100,7 @@ Very (Special|Stable) Operating Platform
 
 %\section*{Understand Debian}
 \columnbreak
-\subsection*{Debian suites}
+\subsection*{Three Debian suites}
 
 % Debian distribution comes in 3 major flavors
 
@@ -115,7 +115,7 @@ Very (Special|Stable) Operating Platform
   requiring the most recent versions of software
 
 %\item[Testing] \emph{Constantly changing future release candidate}\\
-\item[``Always-ready-to-release'']  \emph{Testing} (now \emph{squeeze})\\
+\item[``Always-ready-to-release'']\hfill\emph{Testing} (now \emph{squeeze})\\
 %  What to become a next \emph{Stable} release candidate.\\
   Software versions known to be secure and of good quality.
 %  Software migrated from \emph{Unstable} which is known to be of good
@@ -151,7 +151,7 @@ As soon as \emph{squeeze} gets released, \emph{Testing} will be given
 a new name -- \emph{wheezy}.
 \end{comment}
 
-\subsection*{Debian components}
+\subsection*{Three Debian components}
 
 % Debian distribution comes in 3 major flavors
 %Debian Free Software Guidelines (DFSG)\\
@@ -163,12 +163,12 @@ a new name -- \emph{wheezy}.
   All software in \emph{main} is distributed under FOSS licenses
   compliant with Debian Free Software Guidelines (DFSG) to assure
   complete freedom to use, modify, and (re-)distribute
-\item[Not free \emph{en bloc}]\hfill\emph{contrib}\\
+\item[Wanna-be free]\hfill\emph{contrib}\\
   FOSS depending on \emph{non-free} 3rd party software
 %  Software which, despite being free itself, depends on
 %  \emph{non-free} 3rd party software, rendering it useless without
 \item[Somewhat free]\hfill\emph{non-free}\\
-  Software under restrictive licenses
+  Software under restrictive licenses available at no charge
  % removing some freedoms
  % (\emph{e.g.} non-commercial use only), but which is allowed to be
  % used for free and re-distributed (\emph{e.g. NVidia drivers})
@@ -178,34 +178,32 @@ a new name -- \emph{wheezy}.
 \subsection*{Debian is driven by enthusiastic experts}
 % could be simply 'Debian People' or 'Debian Community'
 
-Debian is the only major Linux distribution developed
-cooperatively solely by individuals through the Internet, in the
-same spirit as Linux and other FOSS.\\
-Debian developers, teams and the community contribute to the
-project not by writing new applications (in most cases), but by
+Debian is the only major operating system developed
+solely by volunteer individuals that collaborate via the Internet.
+Debian developers, teams or individual contributors improve the operating
+system not by writing new applications (in most cases), but by
 \begin{itemize}[nolistsep,topsep=0em,leftmargin=1pc]
 \item integrating existing software into Debian
-\item fixing and communicating bug reports to upstream developers
+\item fixing and communicating bug reports to original developers
 \item assuring overall quality of the distribution
-\item improving documentation and internationalization
+\item improving documentation and translations
 \item providing user support
 \end{itemize}
 
 Packaged software in Debian have individual maintainers which are
-often also the users of that software, so they are interested in its
-reliable operation.  Individual maintainers often join the teams, such
-as Debian-Science or Debian-Med, based on the common field of
-interest.
+often also users of a particular software, and are therefore interested in its
+reliable operation. Certain field of applications have dedicated maintainer
+teams, such as Debian-Science or Debian-Med.
 
 %\columnbreak
-\subsection*{HOWTO get Debian}
+\subsection*{How to get Debian}
 
 %\subsubsection*{Stable}
 \begin{description}[nolistsep,leftmargin=1pc,style=nextline]
 \item[Install on a hard-drive] \url{http://get.debian.net/}
 \item[Boot from CD/USB] \url{http://get.debian.net/live/}
 \item[Run in a Virtual Machine] \url{http://neuro.debian.net/vm.html}
-\item[More options (e.g. buy pre-installed)] \url{http://debian.org/distrib}
+\item[More options (e.g. buy pre-installed machine)] \url{http://debian.org/distrib}
 \item[Testing/Unstable version] \url{http://www.debian.org/devel/debian-installer}
 \end{description}
 
@@ -215,30 +213,25 @@ interest.
 % \url{http://www.debian.org/devel/debian-installer}
 %
 
-\subsection*{HOWTO install software X}
+\subsection*{How to install software}
 
-\begin{description}[nolistsep,leftmargin=1pc,style=nextline]
+GUI (Synaptic): \textit{Select and click ``Apply''}\\
+\includegraphics[width=\columnwidth]{shots/synaptic-fslview}
 
-\item[GUI (Synaptic Package Manager)]
-%  \emph{Synaptic Package Manager}
-  Select X and click ``Apply''\\
-  \includegraphics[width=0.95\columnwidth]{shots/synaptic-fslview}
-\item[Command line]
-  apt-get install X
-\end{description}
+Command line: \texttt{apt-get install <packagename>}
 
 
 
-\subsection*{HOWTO upgrade the entire system}
+\subsection*{How to upgrade the entire system}
 
-\begin{description}[nolistsep,leftmargin=1pc,style=nextline]
-\item[GUI (Synaptic Package Manager)]
-  Click ``Mark All Upgrades'', ``Apply''
-\item[Command line]
-  apt-get update; apt-get dist-upgrade
-\end{description}
+GUI (Synaptic):
 
-\subsection*{HOWTO get support}
+\quad\textit{Click ``Mark All Upgrades'', ``Apply''}\\
+Command line:
+
+\quad\texttt{apt-get update; apt-get dist-upgrade}
+
+\subsection*{How to get support}
 
 \url{http://www.debian.org/support}
 
@@ -246,7 +239,7 @@ interest.
 %\item[GUI]
 %  Use \emph{Synaptic Package Manager}
 \item[Software bug]
-  reportbug X
+  \texttt{reportbug <packagename>}
 \item[Community support]
   %\begin{description}[nolistsep,leftmargin=1pc]
   %\item[Mailing lists] 
@@ -362,51 +355,49 @@ system allows Debian to respond to problems quickly and honestly.
 
 \url{http://neuro.debian.net}
 %\section*{NeuroDebian Project:}
-\section*{The Ultimate Research Platform}
+\section*{The Universal Research Platform}
 \hrule
 
 \end{center}
 
-\section*{NeuroDebian}
-
-is a Debian project aiming to provide Neuroscience community with a
-stable and versatile research platform -- the Debian OS.  NeuroDebian
-(formerly known as Experimental Psychology, ExpPsy) was initiated in
-2006 to provide packaging of PyEPL and FSL software so they could
-become an integral part of Debian, thus seamlessly available to users
-of Debian or any derived distribution.  Since 2006 software coverage
-of NeuroDebian increased more than ten-fold.  NeuroDebian repository
-\url{http://neuro.debian.net} makes recent versions of the software
-available not only for the \emph{Development} but also for previous
-releases of Debian and Ubuntu.  The tandem of a stable generic
-operating system, Debian, together with new versions of research
-software from NeuroDebian repository compose the ultimate research
-platform -- stable versatile environment with recent neuroscientific
-methodologies just 1-click away.  Such stability, ease of software
-installation and system maintenance and constantly growing coverage of
-software solutions made NeuroDebian project popular among
+\section*{NeuroDebian is}
+
+a Debian project aiming to provide the Neuroscience community with a
+stable and versatile research platform -- the Debian OS.
+Since 2005, NeuroDebian integrates neuroscience software into the Debian
+operating system to allow neuroscientists to benefit from the advantages of
+the universal operating system in their day-to-day research activities.
+The NeuroDebian repository
+(\url{http://neuro.debian.net}) offers the latest research software for
+all Debian suites (and various releases of Ubuntu).
+The combination of a stable generic
+operating system, Debian, and a variety of conveniently accessible research
+software creates a versatile research platform for neuroscience that offers the
+latest methodologies of the field for everyone, for free.
+These advantages make NeuroDebian increasingly popular among
 neuroscientists and scientific software developers.
 
 
 \subsection*{NeuroDebian is NOT}
 
-a yet another Debian GNU/Linux derivative distribution.  All work done
-within NeuroDebian project targets software inclusion in the official
-Debian distribution.
+yet another Debian GNU/Linux derivative distribution.  All work done
+by the NeuroDebian project targets the official Debian operating system. This
+approach helps to increase the longevity of the project by relying on the
+efforts of thousands of Debian contributors.
 
 
-\subsection*{Advantages from Debian integration}
+\subsection*{Benefits from Debian integration}
 
 \begin{itemize}[nolistsep,leftmargin=1pc]
 
 % rephrase to outline the benefit, not burden
-\item Debian standards and policies guaranty quality and robustness
+\item Debian standards and policies guarantee quality and robustness
 
 \item Debian centralized bug tracking system provides a unified
   single-point of entry for bug reporting and troubleshooting for any
   software in Debian
 
-\item Debian makes software available within world-wide distribution
+\item Debian makes software available through a world-wide distribution
   network, thus offloading bandwidth demands
 
 \item Other Debian enthusiasts take care about large-scale aspects of
@@ -415,13 +406,13 @@ Debian distribution.
 
 \begin{description}[nolistsep,leftmargin=1pc]
 \item[Porting] Software sources get built for 11 hardware
-  architectures and 3 kernels (Linux, HURD, kFreeBSD). Ports teams
+  architectures and 3 kernels (Linux, HURD, kFreeBSD). Porter teams
   maintain build infrastructure and help making the code
   platform-agnostic.
 \item[QA] Whole-archive rebuilds assure robustness of packaging and
   warn about upcoming problems (core libraries upgrades) beforehand.
-\item[Internationalization (I18n)] I18n teams contribute by localizing
-  software for more than 50 languages
+\item[Internationalization (I18n)] Translator teams help localizing
+  software for more than 60 languages
 \end{description}
 
 \item Neuroscience software becomes 1st-class citizen within Debian
@@ -434,24 +425,22 @@ Debian distribution.
 \end{itemize}
 
 
-\subsection*{NeuroDebian coverage}
+\subsection*{NeuroDebian software coverage}
 \begin{flushright}
 \vspace{-0.5em}
 \url{http://neuro.debian.net/pkgs.html}
 \vspace{-1em}
 \end{flushright}
-\begin{description}[nolistsep,leftmargin=1pc,topsep=0em]
-\item[Electrophysiology] BioSig, Sigviewer, Brian, \ldots
-\item[Machine Learning] PyMVPA, scikits.learn, \ldots
-\item[Medical Imaging] AFNI, Caret, FSL, Mricron, NiPy, Voxbo, \ldots
-\item[Psychophysics] PsychoPy, PyEPL
-\end{description}
+\textit{Electrophysiology:} BioSig, Sigviewer, Brian, \ldots\\
+\textit{Machine Learning:} PyMVPA, scikits.learn, \ldots\\
+\textit{Medical Imaging:} AFNI, FSL, Mricron, NiPy, Voxbo, \ldots\\
+\textit{Psychophysics:} PsychoPy, PyEPL, PyOptical\\
 
 
 
 %\columnbreak
 
-\subsection*{HOWTO get NeuroDebian}
+\subsection*{How to get NeuroDebian}
 \begin{description}[nolistsep,leftmargin=1pc]
 \item[Debian/Ubuntu]\url{neuro.debian.net} repository
 \item[Others] NeuroDebian Virtual Machine
@@ -520,7 +509,7 @@ Pennsylvania, Philadelphia, USA}
 
 \subsection*{Acknowledgements}
 
-We are grateful to all Debian developers and contributors for the
+NeuroDebian is grateful to all Debian developers and contributors for the
 development of Debian OS, and to Prof. James V. Haxby (PBS Department,
 Dartmouth College) for his continued support and endless supply of
 Italian espresso (\url{http://neuro.debian.net/coffeeart.html}).