Sito: istruzioni per la modifica

1 files changed, 106 insertions, 0 deletions

diff --git a/src/laboratorio/sito.txt b/src/laboratorio/sito.txt
new file mode 100644
index 0000000..54b14d5
--- /dev/null
+++ b/src/laboratorio/sito.txt
@@ -0,0 +1,106 @@
+..
+   restindex
+      page-description:
+         Istruzioni su come modificare questo sito
+      /description
+      tags:
+      section: laboratorio
+      encoding: UTF8
+      initialheaderlevel: 2
+   /restindex
+
+   uservalues
+      created: 2012-05-04T06:38:00Z
+   /uservalues
+
+Sito
+====
+
+Questo sito è generato con rest2web_ a partire da sorgenti in 
+reStructuredText_ gestiti in un repository git_.
+
+.. _rest2web: http://www.voidspace.org.uk/python/rest2web/
+.. _reStructuredText: http://docutils.sourceforge.net/rst.html
+.. _git: http://git-scm.com/
+
+Istruzioni per la modifica
+--------------------------
+
+A seconda della complessità della modifica che si vuole effettuare 
+e della frequenza con la quale si pensa di lavorare sul sito
+ci sono più modi per effettuare modifiche.
+
+Segnalare un bug
+~~~~~~~~~~~~~~~~
+
+Per modifiche semplici può essere sufficiente inviare un'email 
+ad `info AT lifolab DOT org` segnalando la modifica che si 
+desidera venga effettuata.
+
+Mandare una patch
+~~~~~~~~~~~~~~~~~
+
+Per modifiche più significative di un paio di paragrafi è molto 
+gradito che la richiesta arrivi corredata da una patch generata 
+con git.
+
+Per farlo, innanzitutto bisogna avere una copia locale del 
+repository, ottenuta ad esempio con::
+
+   git clone git://git.home.trueelena.org/pages/lifo.git
+
+o aggiornarne una già esistente::
+
+   cd $REPO
+   git pull
+
+Si possono quindi effettuare le modifiche che si desiderano, 
+ricordandosi di aggiungere i file modificati e completare 
+un commit per ogni divisione logica delle aggiunte::
+
+   git add file1.txt
+   git add file2.txt
+   git commit -m "Modificata pagina 1 e suo riferimento nella pagina 2"
+
+Se necessario, controllare che il repository upstream non sia stato 
+cambiato e far sì che le modifiche si applichino all'ultima versione::
+
+   git pull --rebase
+
+A questo punto è possibile generare delle patch con tutti i 
+commit aggiunti rispetto ad upstream::
+
+   git format-path origin/master
+
+ed inviarle ad ``info AT lifolab DOT org`` come attachment, 
+ad esempio con::
+
+   git send-email --to=info@lifolab.org 00*.patch
+
+(controllare in ``man git-send-email`` eventuali altre opzioni necessarie, 
+come ad esempio ``--smtp-server=<host>``).
+
+Se le modifiche sono significative e/o controverse può essere 
+oppurtuno inviare la patch sulla `mailing list`_, per richiedere 
+opinioni prima di applicarla.
+
+.. _`mailing list`: contatti.html
+
+Mandare una pull request
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Clonare come sopra il repository, quindi crearne una copia accessibile 
+pubblicamente e pusharvi le proprie modifiche.
+A quel punto inviare una pull-request ad info@ o alla mailing list, 
+come sopra.
+
+Chiedere accesso al repository
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+I frequentatori assidui del laboratorio che pensano di voler 
+effettuare molte modifiche al sito possono ovviamente chiedere 
+accesso al repository principale, in modo da essere autonomi. 
+
+..
+   vim: set filetype=rst sw=3:
+