Consiglio per scrivere una guida

ciao a tutti sto scrivendo una guida pratica all'utilizzo di arduino. In particolare volevo raccogliere tutti i dubbi che vedo circolare sul forum e risolverli creando questa guida scaricabile da tutti, in particolare dai novizi appena aquistata la board. Mi sto rendendo conto che però la guida sarà piena di immagini e molto lunga e quindi secondo voi è meglio fare un pdf unico di 500 pagine o dividere gli argomenti (es. parte ide, parte programmazione, parte hardware ecc..)? il fatto è che molti argomenti sono talmente connessi fra loro che comunque scaricato un tomo dovrebbero scaricarsene un altro XD

infine c'è un topic in cui sono raccolti tutti i link a tutte le guide per coloro che iniziano e non? ad esempio michele per i bootloader, leo per timer e attiny, pighixxx per le connessioni ecc...

Secondo me meglio un unico pdf. Ad esempio le schede di pighi, io cosi divise le trovo scomode.

Anche secondo me in un unico pdf, tipo la guida di Menniti con i link cliccabili sarebbe il top :slight_smile:

Ad esempio le schede di pighi, io cosi divise le trovo scomode

anche io le trovo scomode, se fossero in un unico file sarebbero perfette :smiley:

Secondo me è meglio un unico file pdf con collegamenti ai vari problemi. Come programma per la scrittura ti consiglio Latex, oppure puoi usare Word oppure Open Office.

sto usando libreoffice e poi esporto tutto su pdf comunque la guida mi impegnerà più giorni, ho finito solo di spiegare l'ide ed ora devo spiegare come è fatta la scheda e come funziona il bootloader.

comunque non capisco che intendete per collegamenti, la guida ha i vari capitoli e sottocapitoli e l'indice ha i collegamenti per arrivarci direttamente senza cercarveli (inoltre alla fine ci sarà il glossario dei termini più utilizzati)

Per iscrizione :grin:

peenieman:

Ad esempio le schede di pighi, io cosi divise le trovo scomode

anche io le trovo scomode, se fossero in un unico file sarebbero perfette :D

pighixxx: Per iscrizione :grin:

mi sa che vi ha sentiti XD

superlol:
mi sa che vi ha sentiti XD

Ma figurati, non mi offendo mica anzi accetto volentieri le critiche. :smiley:

superlol:
mi sa che vi ha sentiti XD

Ma la cosa del pdf unico l’aveva già letta come richiesta nel thread relativo alle sue schede. Ha però i suoi buoni motivi per tenerle separate.
Solo che essendo “bloccate” non si possono mettere in un unico pdf dopo il download.

nid69ita: ... Solo che essendo "bloccate" non si possono mettere in un unico pdf dopo il download.

Nid ... sia in ambiente Win che Mac esistono decine di programmi per togliere quel tipo di protezione ai pdf ... ... dato che non vuoi fare nulla di "illegale", ma è solo per tuo uso personale ... pigliati uno di questi programmi, togli la protezione e fatti il tuo pdf ... così ti sistemi le schede anche nell'ordine che vuoi tu ;)

Ah ... ovviamente pighixxx sa benissimo questo ... e sa pure che io l'ho già fatto per raccogliere le sue schede come piace a me :grin:

Guglielmo

gpb01: Ah ... ovviamente pighixxx sa benissimo questo ... e sa pure che io l'ho già fatto per raccogliere le sue schede come piace a me :grin: Guglielmo

Io non uso certi programmacci ]:D :D :D Ah, beh se l'hai già fatto tu, allora me lo "spacceresti" il pdf unico se ti do la mia email in PM ? :grin:

nid69ita: Io non uso certi programmacci ]:D :D :D Ah, beh se l'hai già fatto tu, allora me lo "spacceresti" il pdf unico se ti do la mia email in PM ? :grin:

Non sono "certi programmacci" ... sono normalissimi programmi che trovi nei canali di rivendita "ufficiali" senza dover andare a cercare ... "nel lato oscuro" ... fai una piccola ricerca con Google e vedrai :)

Io su Mac, ad esempio, uso "PDFKey Pro" (http://pdfkey.com/) che ... come vedi, non ha nulla del "programmaccio" ;)

E ... NO, non posso spacciartelo perché, altrimenti, non sarebbe più per mio uso personale e ... violerei i voleri di pighixxx ... :P :P :P

Guglielmo

@Nid

Se non vuoi usare "programmacci" puoi fare una ricerca su Google e trovi n raccolte dell'Abc. :D

pighixxx:
@Nid
Se non vuoi usare “programmacci” puoi fare una ricerca su Google e trovi n raccolte dell’Abc. :smiley:

Ma magari non sono aggiornate. Ora provo. EDIT: boh, non trovo. Solo link al tuo sito (anche su facebook!!!)

Guglielmo, carino “PDFKey Pro” però 20$ per l’uso che ne farei, son un pò tantini (e lo so, son ragno :blush: )

PDF unico, sicuramente.

Altre guide, molto ben fatte, sono scomodissime - specialmente se si mettono ad esempio su un tablet - in quanto suddivise in diversi file.

Ad esempio, c'è una bellissima raccolta di... ehm... va bene, già lo hanno citato... :grin:

paulus1969: pio, c'è una bellissima raccolta di... ehm... va bene, già lo hanno citato... :grin:

Per non dare dispiacere a nessuno nei prossimi giorni invece di unire tutte le schede le smembrerò una per una :grin: Ma questa sarà una sorpresa...

io invece supporto Alberto perchè in fondo avevate le preview XD

il fatto è che un malloppone di svariate pagine potrebbe essere più servibile se diviso. ad esempio le nozioni di programmazione da come funziona l'ide possono stare separate anche se in fondo una lega l'altra.

comunque in effetti ho già scritto abbastanza "che vedremo in dettaglio più avanti nella parte xy" per poter dividerlo XD

A seconda della suddivisione logica, puoi anche creare qualcosa in due volumi ma evita l'eccessiva frammentazione.

Per le schede: Le difficoltà nascono quando si mettono le schede sul tablet. Nella consultazione mediante PC la frammentazione crea dei disagi minori. Usando il tablet, invece, aprire e sfogliare un unico file è incomparabilmente più comodo. Comunque avevo scritto "bellissima raccolta" quindi è ovvio che apprezzo!

Secondo me è un lavoro oneroso e inutile, gli utenti continuerebbero a fare le domande sul forum, poi togli una fetta di utilità generale del forum che insegnerebbe meno cose rinviando l'utente alla tua "enciclopedia dubbi" senza più ascoltare pareri e valutazioni varie.

Pablos, se mi fossi posto i tuoi problemi non avrei scritto la Guida, che oggi ha quasi 100 pagine, tu dici che avrei fatto bene? 25 download al giorno, dopo oltre un anno dalla sua pubblicazione, mi dicono di no ;) Quella Guida ha raccolto ed affrontato quasi tutti i problemi della programmazione, grazie ad essa molti utenti evitano di riproporre questioni lette, dette e ridette, intasando inutilmente il Forum. Poi, quando incontrano difficoltà particolari, diventa interessante anche per noi affrontarle e magari risolverle, aggiungendo nuovi tasselli di conoscenza. Nella sezione MegaTopic ho aperto tempo fa un Topic "LINK UTILI" dove c'è un po' di tutto, segnalazioni che mi sono state fatte di link di ogni natura, mancano i miei perché sono in firma in quasiasi mio post, idem per quelli di Leo. Personalmente sono per il malloppo unico se gli argomenti sono legati tra loro, altrimenti si potrebbe essere costretti a "saltare" da un file all'altro. A separarlo ci sei sempre, magari prima aspetta i pareri dei "lettori". Se ti va, a lavoro finito ma prima della pubblicazione, posso dargli un'occhiata e darti qualche consiglio. Comunque sei da lodare, è da 2 anni che predico che la gente che sa dovrebbe scrivere, ma purtroppo pochi lo fanno. C'è stato un periodo che ho implorato chi avesse conoscense idonee a fare una Guida sul "mondo e le schede ethernet", per insegnare ad acquistare, configurare, utilizzare questi shield, interfacciandoli con server, siti internet e quant'altro; ci sono centinaia di Topi, sempre sugli stessi argomenti, non c'è stato nulla da fare. La stessa cosa stava succedendo per gsm, gprs, gps & co, per fortuna Elettronica In già da qualche numero sta pubblicando una bellissima Guida, ricca di esempi, che poi metterà GRATUITAMENTE a disposizione di tutti coloro che semplicemente si registreranno sul sito.