Mal comune, mezzo gaudio
Uno dei punti che nell’analisi di ieri ho tralasciato, sempre a proposito dello sviluppo di DtPad, è quello relativo alle guida all’utilizzo dell’editor. Come infatti qualcuno avrà avuto modo di notare, insieme agli altri file del pacchetto è presente un eseguibile che si chiama “DtHelp.exe”, il quale in teoria si dovrebbe automaticamente aprire cliccando sulla voce di menu “?” -> “Aiuto”. Tale voce è disabilitata sin dalla prima release beta di DtPad, così come la cartella “Guides” sotto l’applicazione è vuota.
Il motivo di tutto ciò è presto detto: mantenere una guida aggiornata sulle caratteristiche di un prodotto in così costante evoluzione comporta un costo che sinora non ho voluto sobbarcarmi, sebbene abbia già realizzato da tempo l’ambiente necessario per gestirlo (anche in questo caso, sempre per perseguire lo scopo “didattico”, non ho fatto uso di strutture preesistenti, come a esempio gli help offline di Windows). Il rischio che correrei adottando la scelta contraria sarebbe quello di spendere metà del tempo sullo sviluppo (che già non è affatto molto, trattandosi di un hobby) e metà a redigere qualcosa che cerchi di essere realmente utile a un utente, rischiando di ottenere vie di mezzo che non servirebbero a nessuno, me incluso.
Peraltro scrivere una guida non è nemmeno così divertente (sicuramente lo è meno che sperimentare nuove implementazioni)…
Nonostante quindi abbia volontariamente tralasciato questo aspetto per dedicarmi ad altro, la mancanza dell’utilizzo di DtHelp è un punto che mi duole un po’ ricordare. Consola, seppur parzialmente, il fatto che non sono l’unico che si trova in questa situazione. Sabato 4 dicembre l’amministratore del sito di Notepad++, nonché principale autore dello stesso, ha infatti pubblicato questo post:
I have a dream
![]()
In my dream the document online will keep update with Notepad++ developements.
So for each release, the new distribution can just point to this online document site:
http://npp-community.tuxfamily.org/content/notepad-user-manual[…]
Is it a dream or a fantasy? You tell me.
Don
Non è arduo comprendere il punto di vista esposto sopra: avere una guida che resti aggiornata sviluppo dopo sviluppo, senza divenire di fatto inutile a seguito di ciascun rilascio e che quindi rappresenti fedelmente ogni più recente caratteristica del prodotto da essa illustrato, sarebbe il sogno di ogni programmatore. Purtroppo per quanto ci si sforzi, questo processo non si può automatizzare e pertanto la soluzione che l’autore di Notepad++ avanza è quella di affiancare a sé stesso più persone (possibilmente una per lingua) che si occupino, parallelamente al suo lavoro, di aggiornare la documentazione.
Per lui non credo sarà impossibile da ottenere, perlomeno nelle lingue a maggior diffusione, ma per il sottoscritto è certamente qualcosa ben lungi a venire. In fondo comunque, per quanto spiaccia rimandare DtHelp a “glorie” future, non è un punto realmente fondamentale; tuttavia osservando il tutto con occhi diversi si vedrà che il problema è comune anche a tutte quelle realtà lavorative ove è richiesta una documentazione fedele e parallela allo sviluppo, la quale spesso diviene obsoleta (nonché dimenticata) in lassi di tempo sin troppo brevi, rendendo vano quanto già scritto.
Ampliando infine il discorso si potrebbe arrivare ad analizzare planning di progetti in stile “waterfall” o “agile”, sottolineando la differenza di documentazione delle fasi di queste due metodologie di sviluppo e cercare così di applicare tutto ciò anche a realtà minori quale quella di DtHelp, ma comunque la si veda il costo di avere una guida completa resta pressoché invariato. E rimandato a un futuro non tanto prossimo.




nuova visualizzazione calendario all’interno dell’apposito tab contenuto nel pannello laterale
E’ con un pizzico di orgoglio personale che vado a scrivere questo post: come infatti annunciatomi, è stata pubblicata una traduzione in francese di un mio “vecchio” spunto riflessivo sulla traduzione e sulla sua storia, un argomento che, a maggior ragione rileggendolo oggi, ricordo non mi sarebbe spiaciuto approfondire e articolare periodo per periodo. Probabilmente lo farò in un futuro ancora da determinarsi.
