[Docs] Pagina web "Aiutaci"
Antonio Vitale
lampilux a interfree.it
Sab 11 Nov 2006 16:44:11 CET
In allegato il sorgente index.ht della pagina "Aiutaci" del sito
modificata secondo il mio parere.
Provate a dargli un'occhiata e a modificarla tranquillamente dove
ritenete più opportuno.
Tenete conto che:
riga 38: bisogna secondo me riscrivere anche la pagina "Lavori"... se mi
date una lista di essi... posso scrivere anche quella;
riga 61, 62, 63 vanno inserite le corrette posizioni di dove sono
ubicati rispettivamente i documenti "regole.html",
"procedimento_passo_passo.html" e "subversion.html" a seconda se volete
lasciare sul repository tutte le nuove pagine web (secondo me più
opportuno per la manutenzione e l'aggiornamento) oppure direttamente sul
sito (come prima);
Attendo i vostri commenti :-)
Saluti
Antonio Vitale
-------------- parte successiva --------------
Aiutaci!!! - Linguaggio di Programmazione Python
------------------------------------------------
Premessa
''''''''
Python è un linguaggio completo sotto tutti i punti di vista e
sicuramente avrà un futuro roseo.
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://../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://../regole.html;
- **Procedimento passo passo per tradurre/aggiornare un documento**: http://../procedimento_passo_passo.html;
- **Una veloce introduzione a Subversion**: http://../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.
Maggiori informazioni sulla lista
Docs