Skip to content

Come non scrivere un tutorial

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

Share and Enjoy:
  • Print
  • Digg
  • StumbleUpon
  • Facebook
  • Twitter
  • Google Bookmarks
  • FriendFeed
  • Google Buzz
  • HackerNews
  • Posterous
  • Reddit
  • Slashdot
  • Tumblr
This was written by Lawrence. Posted on Saturday, November 5, 2005, at 4:56 pm. Filed under Everything. Tagged . Bookmark the permalink. Follow comments here with the RSS feed. Both comments and trackbacks are currently closed.
  • http://wup.it Giovanni

    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?

  • http://oluyede.org/blog Lawrence

    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 perchenon mi interessa farlo (e personalmente non credo di esserne capace). Dal mio punto di vista e meglio non fare che fare male (nello specifico caso di divulgazione tecnica).

  • http://riffraff.blogsome.com riffraff

    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 :)

  • http://www.blackbirdblog.it Michele

    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.

  • Pingback: PDI^2 :: Come non scrivere un tutorial :: November :: 2005

  • http://michele.sciabarra.com
  • http://oluyede.org/blog Lawrence
  • http://michele.sciabarra.com

    RiffRaff per favore mi puoi contattare per email?

  • Pingback: A song for the lovers » Blog Archive » Come non scrivere un tutorial (parte seconda)

  • fredo

    >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.