[Commits] python.it commit r235 - www/trunk/python.it/help

[commit a svn.python.it]

Author: manlio
Date: Sat Nov 11 18:03:49 2006
New Revision: 235

Modified:
   www/trunk/python.it/help/index.ht
Log:
aggiornamento pagina Aiutaci, di Antonio Vitale

Modified: www/trunk/python.it/help/index.ht
==============================================================================
--- www/trunk/python.it/help/index.ht	(original)
+++ www/trunk/python.it/help/index.ht	Sat Nov 11 18:03:49 2006
@@ -1,179 +1,104 @@
 Title: Aiutaci!!! - Linguaggio di Programmazione Python
+Content-type: text/x-rst
 
+Premessa
+''''''''
 
-<!-- XXX TODO aggiornare  -->
-<h2>Collaborazioni</h2>
+Python è un linguaggio completo sotto tutti i punti di vista e
+sicuramente avrà un futuro roseo.
 
-<p>
-  Questa parte di zonapython.it è tutto sommato il cuore pulsante del
-  sito, come accade per il linguaggio, nessuno dei collaboratori e dei
-  creatori del sito percepisce niente, il tutto è basato sull'aiuto
-  che i volontari offrono.
-</p>
-<p>
-  Si può perciò ben capire quanto sia importante l'apporto di nuovi
-  volontari per la traduzione dei documenti, per la stesura di
-  articoli e quant'altro.
-  Siete pertanto <strong>tutti</strong> invitati a farvi avanti.
-</p> 
-
-<p>
-  Io che vi scrivo sono il webmaster, voglio essere sincero e quindi
-  posso in tutta tranquillità dirvi che la documentazione di
-  questo sito è abbondante, importante ed utile ma c'è un
-  <em>ma</em>...
-</p>
-<p>
-  Python è un linguaggio completo sotto tutti i punti di vista e
-  molto probabilmente avrà un futuro roseo, però è nato e si è
-  sviluppato anche derivando da un altro progetto, il linguaggio
-  "ABC", nato con lo scopo di essere un liguaggio di programmazione
-  per principianti, potente e soprattutto semplice. Questo, per
-  quanto mi riguarda significa anche che i documenti disponibili
-  devono essere il più possibile comprensibili a chi non conosce la
-  programmazione e a chi non conosce l'inglese. Finora già è stato
-  fatto molto per quanto  riguarda i testi di <em>base</em> ma ancora
-  <strong>molto</strong> deve essere fatto per oltrepassare la
-  barriera che divide un programmatore da un
-  principiante. Innanzitutto c'è da tradurre la documentazione
-  ufficiale del linguaggio, per quanto riguarda il 
-  <a href="../doc/Python-Docs/html/tut/" class="strong">tutorial</a>
-  questo è stato fatto ed anche per ciò che concerne la  
-  <a href="../doc/Python-Docs/html/lib/" class="strong">libreria</a>, 
-  che è il <em>cuore</em> del linguaggio siamo a buon punto,
-  attualmente (03 dicembre 2004) è stata appena finita di tradurre ma
-  manca la revisione che ci occuperà qualche mese, intanto è uscito
-  Python 2.4 con annessa la nuova documentazione da
-  aggiornare. Intendiamoci, è stato già fatto un mezzo miracolo,
-  grazie a coloro che hanno collaborato nella traduzione!
-</p>
-<p> 
-  Lo scopo rincipale di questo sito quindi adesso è raccogliere
-  adesioni per la traduzione della documentazione restante, che è ben
-  poca cosa, rispetto a quanto già fatto; magari sarebbe bello
-  costituire un "nucleo" di persone pronte a collaborare.
-</p>
-<p>
-  Consultate la sezione 
-  <a href="../vari/lavori.html">"Lavori in corso"</a> 
-  per sapere attualmente su cosa stiamo lavorando.
-</p>
-   
-
-<h2>I settori dove serve aiuto</h2>
-
-<p>
-  Oltre all'obiettivo da raggiungere di tradurre la restante
-  documentazione del linguaggio, vi sono molti settori per i quali
-  sarebbe importante avere un'aiuto. Non tutti sono disponibili sempre
-  e comunque a tradurre o trovano più divertente fare altre cose, qui
-  di seguito sono indicate le scelte che potete effettuare.
-  Se poi avete altre idee non dovete fare altro che
-  comunicarcele.
-</p> 
-
-
-<h3>Aggiornamenti testi</h3>
-
-<p>
-  In relazione ai libri elencati nell'apposita sezione sorge il
-  problema dell'aggiornamento, più aumentano i libri tradotti e più
-  ci sono testi da "sincronizzare" con i vari rilasci dei rispettivi
-  autori.
-</p>
-<p>
-  Un documento che sarebbe da aggionare con urgenza sarebbe 
-  <a href="../faq/index.html">la FAQ 
-    <img alt="[off-site link]" class="offsitelink"
-         height="15" src="../pics/offsite.gif" width="17" />
-  </a> di www.python.org.
-</p> 
-
-<p>
-  In futuro anche gli altri documenti dovranno essere aggiornati e
-  quindi potete segnalarvi anche come <em>manutentori</em> di un
-  determinato testo, di cui magari siete particolarmente
-  soddisfatti. Per la compilazione dei documenti non avete che da
-  chiedere e vi saranno fornite tutte le indicazioni e i suggerimenti
-  del caso.
-</p> 
-
-
-<h3>Stesura di nuovi articoli</h3>
-
-<p>
-  Gli articoli di presenti in questo sito non sempre sono recenti,
-  alcuni sono particolarmente datati e sarebbe il caso di scriverne
-  di nuovi o quantomeno di aggiornarli.
-</p>
-<p>
-  Se conoscete particolarmente bene un determinato settore di
-  utilizzo di Python prendete in considerazione seriamente l'ipotesi
-  di scriverne un articolo, vi potrebbe servire come appunto da
-  rivedere tra un po' di tempo e farebbe sicuramente comodo a qualche
-  altro utilizzatore. Potete anche segnalarci articoli, sotto il
-  vostro copyright, che avete già pubblicato.
-</p>
-
-
-<h3 id="nuovi">Traduzione di nuovi testi</h3>
-
-<p>
-  Come accennato in precedenza, adesso c'è il problema e del
-  testo da "scegliere", finiamo la doc ufficiale? ;-).
-</p>
-
-
-
-<h3>Aiutare a mantenere e sviluppare il sito</h3>
-
-<p>
-  Per esempio un aiuto servirebbe per proseguire nella traduzione
-  delle pagine della sezione 
-  <a href="../topics/">Indice degli argomenti</a>. 
-  Se confrontate le pagine del sito principale
-  (<a href="http://www.python.org/topics/">http://www.python.org/topics/</a>)
-  potrete notare che sono divise in livelli di profondità maggiore e
-  le pagine presenti in questo sito vi fanno semplicemente un
-  rimando. Occorre tradurle, se ognuno di noi contribuisse nel
-  tradurre anche una sola paginetta in breve tempo quella parte
-  importante del sito sarebbe magnifica, aiutando chi non conosce il
-  linguaggio ad orientarsi immediatamente nella ricerca delle
-  funzionalità cercate.
-</p>
-<p>
-  Contattateci prima però di gettarvi a capofitto nel tradurre una
-  pagina, magari è già stata assegnata...
-</p>
-
-
-<h2 id="coll-0">Come collaborare attivamente</h2>
-
-<p>
-  Collaborare è facile, vi segnalate al 
-  <a href="mailto:webmaster a python.it">webmaster</a> e
-  specificate in quale campo volete collaborare. Le competenze
-  richieste variano a seconda di cosa vorreste fare, se ad esempio
-  volete solamente tradurre è sufficiente la conoscenza della lingua
-  inglese, comunque conoscere anche un po' Python non
-  guasta... ;-)
-</p>
-<p>
-  Vedete la pagina presso 
-  <a href="../vari/lavori.html" class="strong">lavori in corso</a> per
-  maggiori delucidazioni.
-</p>
-<p>
-  Per tradurre la libreria servono veramente <strong>tanti</strong>
-  volontari perciò fatevi sotto!
-</p>
-
-<h2>Come organizzarci</h2>
-
-<p>
-  Useremo la <a href="../vari/ml-0.html">mailing list</a>.
-</p>
-
-<p>
-  Siamo a vs. disposizione.
-</p>
+Il suo sviluppo deriva anche da un altro progetto, il linguaggio
+"ABC", nato con lo scopo di essere un liguaggio di programmazione
+per principianti, potente e soprattutto semplice.
+Questo significa anche che i documenti disponibili devono essere
+il più possibile comprensibili a chi non conosce la programmazione
+e l'inglese.
+
+Per raggiungere questo obiettivo è molto importante la **partecipazione**.
+
+
+Scopo del sito
+''''''''''''''
+
+Lo scopo principale di questo sito quindi è:
+
+- tradurre e mantenere aggiornata quanta più documentazione possibile (usando come riferimento quella disponibile su http://www.python.org);
+- informare sulla realtà italiana di Python (contribuendone allo sviluppo);
+- pubblicare le iniziative e la documentazione degli utenti Python che vogliano condividerle;
+- raccogliere e mettere in pratica i suggerimenti (e anche le critiche) degli utenti che credono che questo sito possa migliorare.
+
+
+Partecipazione
+''''''''''''''
+Per raggiungere tale scopo è ovvio che è necessaria la partecipazione di
+**molti** collaboratori da impiegare su più fronti in base alle loro conoscenze
+e al settore a cui vogliano dedicarsi.
+
+Per maggiori dettagli consultate la sezione **Lavori in corso** http://python.it/vari/lavori.html
+per sapere attualmente su quali fronti stiamo lavorando.
+
+
+I settori dove serve aiuto
+--------------------------
+Oltre all'obiettivo da raggiungere di tradurre la restante documentazione
+del linguaggio e mantenerla aggiornata, ci sono altri settori per i quali
+sarebbe importante avere un'aiuto.
+
+Di seguito sono indicate le scelte che potete effettuare.
+Se poi avete altre idee o iniziative non dovete fare altro che proporle.
+
+
+Aggiornamenti testi
+'''''''''''''''''''
+Settore cruciale: tenete conto che più aumenta la documentazione ed i testi
+tradotti e maggiore è il lavoro di *sincronizzazione* con i vari rilasci.
+Per facilitare e rendere meno noioso questo compito abbiamo creato un
+repository Subversion.
+
+Per maggiori informazioni su come collaborare consultate i seguenti documenti:
+
+- **Convenzioni**: http://python.it/help/regole.html;
+- **Procedimento passo passo per tradurre/aggiornare un documento**: http://python.it/help/procedimento_passo_passo.html;
+- **Una veloce introduzione a Subversion**: http://python.it/help/subversion.html.
+
+
+Stesura di nuovi articoli
+'''''''''''''''''''''''''
+Gli articoli di presenti in questo sito non sempre sono recenti,
+alcuni sono particolarmente datati e sarebbe il caso di scriverne
+di nuovi o comunque aggiornarli.
+
+Se conoscete particolarmente bene un determinato settore di
+utilizzo di Python prendete in considerazione seriamente l'ipotesi
+di scriverne un articolo, vi potrebbe servire come appunto da
+rivedere tra un po' di tempo e farebbe sicuramente comodo a qualche
+altro utilizzatore. Potete anche segnalarci articoli, sotto il
+vostro copyright, che avete già pubblicato.
+
+
+Traduzione di nuovi testi
+'''''''''''''''''''''''''
+Sul sito http://www.python.org c'è molta documentazione utile
+che qui non trovate tradotta. Considerate che svantaggio hanno
+tutti gli utilizzatori di Python che vogliono migliorarne la
+conoscenza ma non conoscono bene l'inglese.
+
+Se siete tra questi proponete quali ritenete sia interessante tradurre
+oltre che per voi anche per la comunità Python italiana.
+Se invece vi è stato utile un articolo e volete tradurlo...questo è
+il posto giusto dove pubblicarlo.
+
+
+Aiutare a mantenere e sviluppare il sito
+''''''''''''''''''''''''''''''''''''''''
+Molte sezioni di questo sito sono oramai datate.
+Questo è un altro settore cruciale in cui abbiamo bisogno di molto aiuto.
+
+
+Come aiutarci
+-------------
+**Collaborare è facile**: contattateci o semplicemente iscrivetevi alla mailing
+list e specificate in quale campo volete collaborare.
+Inutile nascondere che abbiamo bisogno di molti volontari!
+
+Rimaniamo a vs. disposizione.