Start documenting fuss-server

docs/fuss-server.rst

@@ -2,3 +2,37 @@
 FUSS Server
 ***********
 
+``fuss-server`` è uno script python che lancia un playbook ansible_ che
+configura una macchina per poter funzionare come server in una rete
+FUSS.
+
+.. _ansible: https://docs.ansible.com/
+
+fuss-server
+===========
+
+Lo script ``fuss-server`` è scritto per essere compatibile con python 2
+e 3; nel momento in cui ansible passerà ad usare python 3 si potrà
+eliminare la compatibilità python 2.
+
+Playbook
+========
+
+Pacchetti Debian
+================
+
+Il repository prevede la generazione di due pacchetti .deb,
+``fuss-server`` e ``fuss-server-dependencies``; il primo contiene il
+fuss-server vero e proprio, mentre il secondo è un metapacchetto che
+dipende da tutti i pacchetti installati dal playbook ansible.
+
+``fuss-server-dependencies`` non è necessario per l'uso di fuss-server,
+ma è aggiunto per comodità per pre-installare (e soprattutto
+pre-scaricare) tutti i pacchetti necessari.
+
+Numeri di versione
+------------------
+
+Il pacchetto ``fuss-server`` è nativo, quindi il numero di versione è
+del tipo X.Y.Z dove X è il numero di versione debian corrispondente (ad
+esempio 8 per jessie, 9 per stretch, 10 per buster).