Pay attention: the post is in italian because it’s about a tutorial written in this language. So skip if you cannot read 
Ho scritto un articolo su come non scrivere un tutorial basandomi su un tutorial che personalmente trovo pessimo, questo è il link: Qualità dei tutorial in Python
8 Comments
ma quanto e’ presuntuoso e pretenzioso scrivere una cosa cosi’ .. c’hai perso 3 ore almeno tipo.. e per cosa? per scrivere quanto e’ somaro lui (Che c’ha provato ) e quanto figo te (che non hai fatto niente invece)? Aiutalo a migliorare senza sbandierare al pubblico, o fatti i cazzi tuoi?
presuntuoso tanto quanto spacciarsi per un autore di un tutorial e fare consulenza su queste basi. Il resto di quello che scrivi mi metto ad ignorarlo dato che non ne trovo il senso.
ps. guarda che le analisi sugli articoli ci son sempre state. Io non scrivo un tutorial perche
non mi interessa farlo (e personalmente non credo di esserne capace). Dal mio punto di vista emeglio non fare che fare male (nello specifico caso di divulgazione tecnica).non ne sono sicuro, ma a me pare di ricordare che il tutorial non è che l’avesse scritto per il bene del mondo, era per la rivista inter.net (poi Open Source, poi forse è fallita).
A proposito di fare qualcosa per migliorare il tutorial:
nell’originale si leggeva che numeri e stringhe venivano passati per valore, mentre “liste, hash ed oggetti” venivano passati per riferimento.
Ora, siccome ovviamente tutto è un oggetto in python, tutto viene passato per riferimento, io l’ho fatto notare via email, ma il risultato è la pagina che potete leggere adesso sotto “call by value”, che è ancora sbagliata per la prima metà poi si riprende un po’ e poi prosegue con “facendo s=s+c viene creata una copia”.
Insomma serve a niente provare a far migliorare una cosa se tanto non si viene ascoltati
Sono dell’idea che bisogna essere sicuri di quello che si scrive, specialmente se si scrive per una rivista. Si può passare sopra ad alcuni errori ed imperfezioni ma non si può scrivere un tutorial solo per il gusto di farlo, inserendo una serie di imperfezioni ed errori sistematici.
Prima di pubblicare un articolo del genere basterebbe farlo leggere ad altre persone che possono correggere eventuali errori.
Ricordiamo che lo scopo è quello di far capire in maniera esatta le cose a chi legge.
La mia risposta:
http://michele.sciabarra.com/p.....rso_Python
il link corretto: http://michele.sciabarra.com/p.....so_Python2
RiffRaff per favore mi puoi contattare per email?
>Le variabili hanno tipo eccome, altrimenti non esisterebbero. Non esistono variabili non >tipizzate in Python. Le variabili non sono come scatole, al massimo sono etichette. Una > >variabile ha sempre un tipo, [...] Consiglio di leggere questo: > http://docs.python.org/ref/objects.html
La variabili non hanno tipo in python: sono i dati ad averlo.
2 Trackbacks/Pingbacks
[...] rhymes ha scritto un pezzo di contestazione riguardo lo scarso valore di certi articoli/manuali/tutorial in italiano. Non so se fosse collegato a questa entry sul blog di html.it, che parla della scarsa qualità degli articoli su riviste cartacee, ma in effetti a me pare che ci sia una scarsità qualitativa diffusa sia on line che off line. [...]
[...] In relazione a questo post: Come non scrivere un tutorial, l’autore del tutorial incriminato ha deciso di rispondere (giustamente) punto per punto alle mie critiche in questo post: http://michele.sciabarra.com/p.....so_Python2 [...]