update introduction (debian version)

chapters/introduction.qmd

@@ -1,9 +1,11 @@
-# Introduction
+# Overview
+
+## Introduction
 
 
 The FRB-CESAB server **Rossinante** is dedicated to *medium* performance 
 scientific computing (see @tbl-hardware for hardware specification). 
-It runs under the Operating System (OS) **Debian 12** (Bookworm).
+It runs under the GNU/Linux distribution **Debian 12** (Bookworm).
 
 
 **When do you want to use Rossinante?**
@@ -26,35 +28,57 @@ It runs under the Operating System (OS) **Debian 12** (Bookworm).
 : Hardware specifications {#tbl-hardware}
 
 
-You can run programs implemented in R, Python, Julia, Shell script, C, C++, etc. 
-directly from a terminal or using Web clients like [RStudio Server](https://support.posit.co/hc/en-us/articles/200552306-Getting-Started) or 
-[Jupyter Notebook](https://jupyter.org/).
+You can run programs implemented in R, Python, Shell script, C, C++, etc. 
+directly from a terminal, using Web clients like [RStudio Server](https://support.posit.co/hc/en-us/articles/200552306-Getting-Started) or 
+inside [Docker](https://www.docker.com/) containers.
 
 
 ::: {.callout-important}
 ## Important
 
 No job scheduling system (e.g. SLURM, Torque) has been installed. This means 
-that you can launch jobs whenever you want. However you are invited to read 
-@sec-good-practices (Good practices).
+that you can launch jobs whenever you want. However you are invited to respect some rules
+(@sec-good-practices).
 :::
 
 
+## Storage
+
+You have access to four personal directories:
+
+- `/home/you/`
+- `/media/sancho/you` (external drive)
+- `/media/seagate/you` (external drive)
+- `/media/cervantes/you` (external drive)
+
+You can create, edit and remove any files/directories you want inside these directories.
+
+::: {.callout-important}
+## Important
+
+Rossinante is **not a storage server**. The 30 TB of storage are shared
+among all users. You can store large datasets to run yours
+analyses, but once you're done, please remove these files.
+
+**There is no backup system!** You are responsible for your data.
+:::
+
 
-**What are the available software?**
 
-- [`R`](https://cran.r-project.org/) (latest version)
-- [`RStudio Server`](https://www.rstudio.com/products/rstudio/download-server/)
-- [`Python 3`](https://www.python.org/) (latest version)
+## Available software
+
+- [`R`](https://cran.r-project.org/) -- Scientific computing (among others)
+- [`RStudio Server`](https://www.rstudio.com/products/rstudio/download-server/) -- Web interface for R
+- [`Python 3`](https://www.python.org/) -- Scientific computing (among others)
 - [`pip3`](https://pip.pypa.io/) -- Python packages managers
-- [`Pandoc`](https://pandoc.org/)
-- [`Quarto`](https://quarto.org/)
-- [`git`](https://git-scm.com/)
-- [`make`](https://www.gnu.org/software/make/)
-- [`Docker`](https://www.docker.com/)
+- [`Pandoc`](https://pandoc.org/) -- Universal document converter
+- [`Quarto`](https://quarto.org/) -- Scientific publishing system
+- [`git`](https://git-scm.com/) -- Version control system
+- [`make`](https://www.gnu.org/software/make/) -- Project compilation
+- [`Docker`](https://www.docker.com/) -- Containerization
 
 
-And some useful utilities:
+## Useful utilities
 
 - [`FFmpeg`](https://ffmpeg.org/) -- Transcoding multimedia files
 - [`ImageMagick`](https://imagemagick.org) -- Image manipulation program
@@ -68,35 +92,16 @@ And some useful utilities:
 - [`tree`](http://mama.indstate.edu/users/ice/tree/) -- Recursive directory listing program
 - [`curl`](https://curl.se/) and [`wget`](https://www.gnu.org/software/wget/manual/wget.html) -- Download managers
 - [`zip`](https://linuxize.com/post/how-to-zip-files-and-directories-in-linux/) and [`unzip`](https://linuxize.com/post/how-to-unzip-files-in-linux/) -- ZIP files managers
-- [`zsh`](https://www.zsh.org/) - Unix shell (alternative to Bash)
-
-**Can you do everything you want on Rossinante?**
+- [`zsh`](https://www.zsh.org/) -- Unix shell (alternative to Bash)
 
-No!
-
-Rossinante has only **one administrator**. Regular user,
-like you, has limited permissions.
-
-You have access to four personal directories:
-
-- `/home/you/`
-- `/media/sancho/you` (external drive)
-- `/media/seagate/you` (external drive)
-- `/media/cervantes/you` (external drive)
 
+## Missing software
 
 If you need to use a non-installed software, please contact the administrator.
+
 Note that each user has a personal R library in which he/she can install every
 R packages he/she wants (independently of other users). For Python, packages are
 shared among all users (except if you work with virtual environments **[recommended]**).
 
 
-::: {.callout-important}
-## Important
-
-Rossinante is **not a storage server**. Its limited storage is shared
-among all users. You can store large dataset to run yours
-analyses, but once you've finished, please remove these files.
 
-**There is no backup system!**. You are responsible for your data.
-:::