Merge branch 'boringMDFiles' into 'master'

Boring md files

Aggiungi file MD per gli autori e su come contribuire

See merge request !2

AUTHORS.md

+This site was started in 2015 and has received many contributions from the
+following people.
+
+In addition, numerous translations, bug reports and other non-code contributions
+have been made which are equally valued.
+
+Pietro Albini       <pietroalbini@ubuntu.com>
+Riccardo Padovani   <rpadovani@ubuntu.com>

CONTRIBUTING.md

+Ciao, e grazie per il tuo interessamento su come migliorare il sito web di
+Ubuntu-it :-)
+
+
+## Come contribuire
+
+Il Gruppo Web è composto dai contributori occasionali e dal core team. Fanno
+parte del core team tutti quei contributori che hanno mostrato costanza nel
+partecipare alle attività del team. Chi fa parte del core team ha la membership
+del gruppo ubuntu-it-www su Launchpad, come segno di riconoscimento. La
+membership ha rinnovo semestrale.
+
+
+### Cosa c'è da fare
+
+Non c'è bisogno di essere sviluppatori per aiutarci :-) Basta avere voglia di
+fare e di imparare. Di seguito scriviamo le tre maggiori aree di contributo, ma
+se pensi che le tue abilità possano servirci e vuoi aiutarci, scrivici!
+
+
+### Prerequisiti
+
+- Creazione di un account Launchpad
+- Richiesta di un account su code.ubuntu-it.org
+- Firma del codice di condotta
+- Conoscere l'inglese, almeno a livello basilare
+
+
+### Design
+
+Hai qualche suggerimento su come migliorare il tema, o vuoi creare immagini da
+mettere sul sito, ma non sai programmare? Non c'è problema, scrivici i tuoi
+suggerimenti, ci penseremo noi a trasformarli in realtà ;-)
+
+Per iniziare, iscriviti alla nostra [mailing list][ml] e presentati, linkando il
+tuo account Launchpad e spiegando cosa vuoi fare!
+
+
+### Contenuti
+
+Ti piace scrivere? Sai creare contenuti che attirano e sorprendono? Vienici a
+trovare! Il sito web è in continua espansione, e aggiungiamo sempre nuove pagine
+con i nuovi fantastici contenuti della comunità e di Ubuntu stesso.
+
+
+### Sviluppatori
+
+Il sito è un sito statico, generato da Python grazie a Flask - non conosci
+queste tecnologie? Non preoccuparti, basta sapere un po' di HTML e un po' di CSS
+per poter aiutarci a scrivere il codice!
+
+Il tema è basato sull'[Ubuntu Vanilla Theme][vanilla] sviluppato da Canonical,
+con alcune modifiche apportate da noi.
+
+Non conosci niente di tutto questo ma vuoi imparare? Sei il benvenuto, questo è
+un team dove si impara tutti insieme :-)
+
+Per iniziare, puoi installare il sito e il tema in locale e iniziare a guardare
+i bug presenti su questo sito
+
+Nel frattempo, iscriviti alla nostra [mailing list][ml] e presentati, linkando
+il tuo account Launchpad, ti forniremo un account su code.ubuntu-it.org, dove è
+ospitato il nostro codice.
+
+Il server di test è ospitato a questo indirizzo:
+[http://wwwtest.ubuntu-it.org][test]
+
+Fai anche un salto su [#ubuntu-it-web su Freenode][irc] per conoscerci, così
+parliamo di cosa c'è bisogno di fare. Come avrai notato, il lavoro è tanto ;-)
+
+
+## Istruzioni per gli sviluppatori
+
+Innanzitutto, ricordati che devi configurare git per poter lavorare con questo
+sito, così come spiegato [qua][git].
+
+
+### Git workflow
+
+Una cosa importante: per ogni contributo (un bug fix, una nuova feature), crea
+un nuovo branch partendo da `master`. Per ovvie ragioni non puoi pushare
+direttamente in master, ma dovrai fare una `Merge Request` e aspettare che
+qualcuno del team faccia una review.
+
+Controlla quindi di essere nel master, avere il codice aggiornato, e crea il tuo
+branch:
+
+```
+git checkout master
+git pull
+git checkout -b ilMioNuovoContributo
+```
+
+E ricordati di aggiungere il tuo nome al file AUTHORS.md ;-)
+
+### Preparare l'ambiente per lo sviluppo
+
+*Testato su Ubuntu 14.04*
+
+Per preparare l'ambiente di sviluppo è necessario disporre di Python 3,
+[virtualenv][2], [pyinvoke][3] e nodejs.
+
+```
+pip install invoke
+```
+
+Dopo averli installati si può generarlo con il seguente comando:
+
+```
+invoke devel
+```
+
+Esso scaricherà tutte le dipendenze da internet (la prima volta), compilerà gli
+assets e creerà un virtualenv con dentro installato il sito (in modalità
+modificabile). Per attivare il virtualenv, bisogna dare in ogni sessione di
+terminale il seguente comando:
+
+```
+source build/envs/devel/bin/activate
+```
+
+Se si modificano gli assets è necessario ricompilarli. Lo si può effettuare con
+il seguente comando:
+
+```
+invoke assets
+```
+
+In caso si facciano modifiche frequenti, può risultare conveniente l'aggiunta
+della flag `-w` al comando, che ricompila gli assets quando sono rilevate
+modifiche.
+
+### Esecuzione del sito in locale
+
+Per eseguire il sito in locale, è possibile eseguire questo comando (una volta
+dentro il virtualenv o con il sito installato globalmente):
+
+```
+uitwww run -d -p 8000
+```
+
+Esso avvierà un'istanza in debug-mode (*da non eseguire in produzione!!!*), che
+ascolta su [localhost:8000][localhost]. Se si vuole attivare anche la cache
+statica, bisogna aggiungere come argomento il path della directory che la dovrà
+contenere:
+
+```
+uitwww run -d -p 8000 path/to/cache
+```
+
+## Generazione di una build
+
+Per creare una build dell'intero sito, è necessario disporre di Python 3,
+[virtualenv][2], [pyinvoke][3] e nodejs. Dopo averli installati si può crearla
+con il seguente comando:
+
+```
+$ invoke build
+```
+
+Esso scaricherà tutte le dipendenze da internet (la prima volta), compilerà gli
+assets e genererà il pacchetto, salvandolo in ``build/packages``. È possibile
+rimuovere tutti i file creati dal processo con il comando:
+
+```
+$ invoke clean
+```
+
+[2]: https://virtualenv.pypa.io
+[3]: http://www.pyinvoke.org
+[git]: http://code.ubuntu-it.org/ubuntu-it-web/www/wikis/git-setup
+[ml]: http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-web
+[irc]: http://chat.ubuntu-it.org/#ubuntu-it-web
+[vanilla]: https://github.com/ubuntudesign/ubuntu-vanilla-theme
+[test]: http://wwwtest.ubuntu-it.org
+[localhost]: http://localhost:8000

README.md

@@ -3,74 +3,44 @@
 Questo repository contiene tutto il codice sorgente del [sito web][1] di
 ubuntu-it. Il tutto è rilasciato sotto licenza GNU-AGPL v3+.
 
-Il sito è realizzato con [flask](http://flask.pocoo.org) e Python 3.
+Per contribuire dai un'occhiata al file CONTRIBUTING.md
 
-## Esecuzione del sito in locale
+Il gruppo web si pone come obiettivo la diffusione, con la massima chiarezza e
+semplicità, di tutte le informazioni necessarie all'utenza italiana di Ubuntu,
+aggiornamento notizie e informazioni generali di supporto, ad integrazione degli
+altri gruppi della comunità italiana.
 
-Per eseguire il sito in locale, è possibile eseguire questo comando (una volta
-dentro il virtualenv o con il sito installato globalmente):
 
-```
-$ uitwww run -d -p 8000
-```
+## Chi siamo
 
-Esso avvierà un'istanza in debug-mode (*da non eseguire in produzione!!!*), che
-ascolta su `localhost:8000`. Se si vuole attivare anche la cache statica,
-bisogna aggiungere come argomento il path della directory che la dovrà
-contenere:
+- DarioCavedon (*ic3d*) - **Amministratore**
+- PietroAlbini (*pietroalbini*) - **Amministratore**
+- RiccardoPadovani (*rpadovani*)
+- PaoloRotolo (*paolorotolo*)
+- MattiaMigliorini (*deshack*)
+- SilviaBindelli (*Dolasilla*)
+- EmanueleBoncimino (*almaidinajad*)
+- LucaLumetti (*lumetti-luca*)
+- MercuryTuts (*mercurytuts*)
 
-```
-$ uitwww run -d -p 8000 path/to/cache
-```
 
-## Generazione di una build
+## Planet Ubuntu-it
 
-Per creare una build dell'intero sito, è necessario disporre di Python 3,
-[virtualenv][2], [pyinvoke][3] e nodejs. Dopo averli installati si può crearla
-con il seguente comando:
+Il [planet italiano di Ubuntu][planet] è gestito dal gruppo Web.
 
-```
-$ invoke build
-```
+Per qualunque informazione, segnalazione o suggerimento che riguarda il planet,
+scrivere a planet@ubuntu-it.org.
 
-Esso scaricherà tutte le dipendenze da internet (la prima volta), compilerà gli
-assets e genererà il pacchetto, salvandolo in ``build/packages``. È possibile
-rimuovere tutti i file creati dal processo con il comando:
 
-```
-$ invoke clean
-```
+## Contatti
 
-## Hacking
+Per qualunque informazione, segnalazione o suggerimento che riguarda il Gruppo
+Web potete:
 
-Per preparare l'ambiente di sviluppo è necessario disporre di Python 3,
-[virtualenv][2], [pyinvoke][3] e nodejs. Dopo averli installati si può
-generarlo con il seguente comando:
+- scrivere a gruppo-web@ubuntu-it.org.
+- postare nella [sezione rilevante sul forum][forum]
 
-```
-$ invoke devel
-```
-
-Esso scaricherà tutte le dipendenze da internet (la prima volta), compilerà gli
-assets e creerà un virtualenv con dentro installato il sito (in modalità
-modificabile). Per attivare il virtualenv, bisogna dare in ogni sessione di
-terminale il seguente comando:
-
-```
-$ source build/envs/devel/bin/activate
-```
-
-Se si modificano gli assets è necessario ricompilarli. Lo si può effettuare con
-il seguente comando:
-
-```
-$ invoke assets
-```
-
-In caso si facciano modifiche frequenti, può risultare conveniente l'aggiunta
-della flag `-w` al comando, che ricompila gli assets quando sono rilevate
-modifiche.
 
 [1]: http://www.ubuntu-it.org
-[2]: https://virtualenv.pypa.io
-[3]: http://www.pyinvoke.org
+[planet]: http://planet.ubuntu-it.org
+[forum]: http://forum.ubuntu-it.org/viewforum.php?f=45