Collaborate allo sviluppo FidoCadJ!

[DarwinNE]

N.B. per i link, vedere l'informazione in fondo a questo messaggio

Buongiorno a tutti,
partecipando alla comunità di ElectroYou, siete probabilmente a conoscenza di FidoCadJ, l'editor vettoriale dedicato all'elettronica e che è nato per mia iniziativa. Su consiglio di admin, riprendo in questa discussione alcune cose che sono state dette qui: http://www.electroyou.it/phpBB2/viewtop ... 0&p=265346

FidoCadJ è uno strumento open source pubblicato con licenza GPL, completamente gratuito e può essere scaricato e copiato liberamente. E' un progetto che ha vocazione di essere usato non solo in Italia, quindi è stato tradotto in diverse lingue. Il punto di ritrovo è la pagina dedicata a FidoCadJ sul portale SourceForge:

http://sourceforge.net/projects/fidocadj/

Il suo sviluppo riposa sugli sforzi dei volontari che partecipano al progetto.
E' quindi indispensabile che vi siano persone disposte a dedicare non il proprio denaro, ma semmai una parte del loro tempo per contribuire attivamente a FidoCadJ. Se il programma vi piace, pensate a ringraziare la comunità degli sviluppatori diventandolo a vostra volta!

Se queste persone vengono a mancare, il progetto FidoCadJ non può avere lunga vita.

Le quasi 26k linee di codice Java che compongono FidoCadJ non sono poi tantissime (anzi), ma sono già una quantità sufficiente a far fuggire a gambe levate tanti che programmatori professionisti non lo sono. Ma io non sono un programmatore professionista, quindi ciò prova che qualcosa si può comunque fare anche non lavorando nel settore informatico.

Voglio partecipare allo sviluppo? Cosa posso fare?

In un progetto open source, si può contare solamente sulla buona volontà di chi vi partecipa. Questo vuole dire che non sono in posizione per imporre nulla (ma sono io che decido l'apertura del repository agli utenti che hanno diritto di scriverci sopra). Per il resto, per avere qualche idea, copio ed incollo a partire dal README:

Codice: Seleziona tutto

4.3 Things to do
----------------

-------------------------------------------------------------------------------
Review on SourceForge or OhLoh      It is important that the users and
                                    developers of FidoCadJ understand what is
                                    good and what is bad in their favourite
                                    software. Do not be shy to review FidoCadJ
                                    on SourceForge or OhLoh!
-------------------------------------------------------------------------------
Translate user interface            Everything is done on FidoCadJ to make it
                                    easy to translate its interface in any
                                    language. You can significatively
                                    contribute to the spread of FidoCadJ in
                                    your country!
-------------------------------------------------------------------------------
Translate manual                    This is an hard work, but it will be very
                                    welcomed by the users of your country. You
                                    will probably need an idea on how LaTeX
                                    works.
-------------------------------------------------------------------------------
YouTube video tutorial              I will put on the FidoCadJ's page a link to
                                    the best video tutorials about FidoCadJ on
                                    YouTube. Why don't you give it a try?
-------------------------------------------------------------------------------
Report bugs                         Use the bug and artifact tracking system of
                                    SourceForge or drop me an email.
-------------------------------------------------------------------------------
Export in Gerber format             Exporting in graphical vector formats is
                                    easy with FidoCadJ. If you want to add a
                                    file format you just need to know it and
                                    implement a Java interface. Gerber is
                                    highly requested by people working on PCBs.
-------------------------------------------------------------------------------
Export in WMF/EMF formats           WMF/EMF are widely used in Windows and they
                                    may be useful for including drawings in
                                    vector format in Microsoft Word or Power
                                    Point.
-------------------------------------------------------------------------------
Windows installer                   FidoCadJ does not come with a standard
                                    Windows installer. Can you prepare one?
-------------------------------------------------------------------------------
Linux packaging                     FidoCadJ could be distributed as a deb or a
                                    RPM package. Can you prepare one?
-------------------------------------------------------------------------------


Un altro esempio che non ho citato nella lista è che quando vengono fatte delle modifiche più o meno profonde alle primitive, queste devono essere implementate anche in TUTTI i formati grafici in cui FidoCadJ esporta, ovvero PDF, EPS, SVG, PGF. Per ogni formato mi sono studiato i manuali che descrivono i vari comandi (il PDF a basso livello non è una passeggiata). Ecco, per esempio mi farebbe piacere poter delegare cose come queste ad un gruppo di persone. L'ideale sarebbe lavorare in coppia, con qualcuno che scriva il codice e qualcun altro che fa test approfonditi. Il codice per l'esportazione è stato descritto qui abbastanza in dettaglio:

http://sourceforge.net/projects/fidocad ... ic/3581648

Oppure basta guardare i numerosi commenti disponibili in uno dei file che si occupano dell'esportazione:

http://fidocadj.svn.sourceforge.net/vie ... iew=markup

(questo è relativo al formato SVG). In questo senso, va anche questa mia richiesta:

http://sourceforge.net/projects/fidocad ... ic/4907382

Tenete a mente però una cosa: E' importante che tutto quello che riguarda i contributi al codice od ad altri aspetti del programma sia fatto e discusso su un forum pubblico e non per email o per messaggi privati. Questa è per esempio una discussione che ho avuto con un ragazzo a cui ho dato in passato il diritto di scrivere sul repository di FidoCadJ:

http://sourceforge.net/projects/fidocad ... ic/4798719

Mi ha spiegato cosa voleva fare (motivato da un mio commento tipo: 'questo codice fa schifo'), mi ha mostrato il codice e, dopo un po' di tentativi, è finalmente riuscito a rispettare alcune regolette che ho nella scrittura del codice. Attenzione solo che partecipare a discussioni come quelle mi prende molto tempo... se mi ci vuole più sforzo per spiegare a qualcuno come scrivere del codice che scriverlo io stesso, il saldo è in negativo per quanto riguarda il totale di "forza lavoro" disponibile per FidoCadJ (per la legge di Brooks, descritta nel The mythical man month). Questo a meno che poi lo sforzo non venga ripagato sul lungo periodo. Quindi l'ideale è dare magari un contributo piccolo, ma evitare le cose fatte una tantum, del tipo 'traduco una robetta e poi sparisco', perché poi chi traduce il resto o le modifiche eventualmente necessarie in un secondo tempo (che magari sono piccole, ma importanti)? Allo stesso modo, gli standard qualitativi da rispettare dovranno essere coerenti con il resto del programma.

Molti sono armati di buona volontà, ma non sanno programmare. La programmazione rappresenta solo circa il 50% dello sforzo di sviluppo. Se mi è concesso auto-citarmi:

http://www.electroyou.it/darwinne/wiki/ ... electroyou

Molti di solito sono un po' spaventati all'idea di contribuire ad un progetto open source perché quando uno pensa al lavoro che c'è dietro ad un programma vede quasi sempre solo il codice. In realtà, si può dare un reale contributo allo sviluppo di FidoCadJ anche senza scrivere una sola linea di codice Java. Si può per esempio controllare che la documentazione sia completa ed efficace, mettere a punto tutorial e segnalare i problemi che si riscontrano. Chi conoscesse un po' le lingue può pensare a tradurre il programma o il manuale...
Non vorremmo con questo allontanare coloro interessati a lavorare sul codice sorgente. Una cosa che interesserebbe molte persone per esempio sarebbe l'aggiungere nuovi formati vettoriali per esportazione.
Naturalmente, per coordinare un po' gli sforzi, discutiamone sul forum dedicato a FidoCadJ!

Per esempio, ci sarebbe bisogno di una revisione per le lingue in cui FidoCadJ è stato tradotto: inglese, francese, tedesco, spagnolo.

Se apprezzate FidoCadJ e volete partecipare attivamente al suo sviluppo, leggete attentamente tutta la documentazione disponibile, imparate ad utilizzare Subversion, eventualmente scaricatevi il codice sorgente, ricompilate il programma. Leggete con attenzione il README, leggete il codice sorgente, leggetevi i numerosi commenti. Se volete sapere come funzionano alcuni meccanismi interni, fate domande sul forum di SourceForge, ma siate propositivi e realisti. Non chiedetemi di scrivere un manuale di 200 pagine per dettagliare tutti i dettagli del codice (è una richiesta che ogni tanto arriva), se poi non siete disposti a leggerlo per più di tre o quattro minuti. Se invece avete capito bene un meccanismo, oppure pensate che alcuni aspetti della documentazione siano carenti, datevi da fare per colmare le lacune.

Se siete interessati, manifestatevi sul forum di SourceForge:

http://sourceforge.net/projects/fidocad ... rum/997486

Le discussioni sono preferibilmente in inglese, anche se come potete vedere l'italiano è comunque tollerato.

Grazie!

INFORMAZIONE IMPORTANTE: nell'agosto 2015, abbiamo deciso di far migrare il progetto FidoCadJ su GitHub, che è molto più efficace e moderno di SourceForge.

Il nuovo indirizzo del progetto è questo: https://github.com/DarwinNE/FidoCadJ
Il nuovo indirizzo del sito del programma è questo: http://darwinne.github.io/FidoCadJ/

[DarwinNE]

Ecco un'altra idea non troppo difficile che non richiede troppo lavoro...

I ragazzi di IHRaM mi hanno fatto notare che la loro libreria è passata dalla versione 3.0 alla versione 3.1, contenente qualche simbolo in più, nonché qualche correzione:

https://groups.google.com/group/it.hobb ... 13809c086#
(leggete il mio messaggio scritto come "Darwin")

Qualcuno potrebbe provare ad aggiornare la versione attualmente presente in FidoCadJ (la 3.0), il lavoro più grosso sarebbe fare il lavoro di aggiornamento della versione in inglese che viene utilizzata quando FidoCadJmostra lingue diverse dall'italiano. Bisognerà trovare le differenze fra le due librerie ed integrarle.

Se qualcuno fosse interessato, mi contatti sul forum di Sourceforge indicato nel primo messaggio.

[DirtyDeeds]

Per la versione inglese posso pensarci io, però anche per questa non in tempi brevissimi. Ti contatterò poi anche alla fucina dei sorgenti

[DarwinNE]

DirtyDeeds, ti ringrazio moltissimo per questa tua proposta. Non credo che ci sia nessuna fretta. Manifestati sul forum della 'fucina', e ti darò quanto mai volentieri accesso in scrittura al repository SVN.

[OberoN]

Si potrebbero aggiungere alla libreria standard, su "IC Digitali", i flip-flop:

Sorgente FidoCadJ | Ingrandisci | Cos'è Fidocad

[DarwinNE]

Mi pare una buona idea, anche perché è capitato anche a me di cercare qualche flip flop. La risposta breve sarebbe di proporti di mettere a punto una libreria di elettronica digitale. Maggiori informazioni su come fare una libreria con FidoCadJ le trovi qui:

https://sourceforge.net/projects/fidoca ... ic/4081566

La risposta lunga invece sarebbe di rivedere l'intera libreria standard. Ci sono tante cose da decidere. La discussione in corso (a cui in questo momento manca purtroppo di linfa vitale) è questa:

https://sourceforge.net/projects/fidoca ... ic/4714615

[kevinpirola]

Ciao, sono un programmatore Java, non ho moltissimo tempo però visto che questa community mi sta dando tanto, qualcosina vorrei poter ricambiare. Sono estraneo al mondo sourceforge e (vista l'ora) non ho aperto nemmeno uno dei link che hai postato, però se riesci a spiegarmi in due righe più o meno cosa ci sarebbe da fare, magari un occhio sul codice lo butto. Anche se al momento non so come muovermi su sourceforge (aiuto).

Ripeto, non ho moltissimo tempo, però se posso ogni tanto faccio qualcosa.

[DarwinNE]

Ciao kevinpirola,
ti ringrazio per la proposta, le cose da fare sarebbero tante, qualcuna l'ho citata sopra, altre sono state dibattute su SourceForge (SF).
Per scaricarti il codice da SF, hai bisogno di utilizzare Subversion (SVN). Non è particolarmente difficile da utilizzare e credo che con Windows ci sia un programmino simpatico che si chiama TortoiseSVN capace di semplificare alquanto la vita.
Non tutto il codice è scritto benissimo, anche è abbastanza commentato. Se ci sono punti non chiari o comunque cose da discutere, il punto di incontro è il forum di SF.
Detto questo, ti consiglierei di leggere i link che ho fornito, provare a scaricarti il codice ed a compilarlo (leggi bene anche il README che viene assieme ai sorgenti). Dopodiché dovresti aver le idee più chiare su un certo numero di cose e potremo discutere sul da farsi.
Forse la prima cosa da fare se ti interessa collaborare è scrivere un post sul forum di SF presentandoti in breve e dicendo quali sono le tue competenze (meglio in inglese anche se l'italiano è comunque tollerato). Lì discuteremo sul da farsi.

Ciao!

[kevinpirola]

conosco bene svn, ho eclipse collegato con subclipse, appena ho un po' di tempo in questi giorni mi ci dedico un attimo

[DarwinNE]

Perfetto allora!
Tieni solo conto che io non uso Eclipse e quindi dovrai crearti da te i file di progetto eccetera... Ci sono comunque alcuni script Unix che funzionano da terminare e che uso per compilare tutto. Trovi maggiori informazioni su questo nel file README.