In occasione di un rilancio della documentazione di DrupalItalia.org colgo l'occasione di esporre il mio punto di vista sulla questione Documentazione per il software Libero ed Open Source (Stallman non sarebbe contento, perdonami), che a discapito di quanto qualcuno può pensare essa rappresenta una componente essenziale di un programma ben scritto.
In software o una porzione di codice non è realmente libero se non possiede un altrettanto libera documentazione sufficente a indicarne il suo funzionamento base, purtroppo in campo informatico questo aspetto stenta a farsi strada, anche e soprattuto tra professionisti del settore. Ti starai sicuramente chiedendo: "ma perchè mai dovrei rilasciare la documentazione libera di un software libero?". La risposta è semplice quanto essenziale.
Un sofwtare Libero o in alcuni caso quello OpenSource ha come componente importante della sua filosofia di diffusione proprio la possibilità di apportare modifiche liberamente e distribuire queste modifiche e/o lintero sofwtare modificato. Mi sembra chiaro che le modifiche possono essere di diverse entità, grandi, piccole, impegnative e/o complesse... e anche esse hanno bisogno del supporto di una documentazione a volte essenziale. A questo punto il programmatore che ha realizzato la modifica al sofwtare avrà realizzato la relativa documentazione che vorrebbe inserire, come ha fatto con il codice, nella documentazione completa del sofwtare in questione.
In questo modo oltre ad aver prodotto una modifica o una feature utile alla comunità avrà migliorato la documentazione mantenendola aggiornata coerentemente con le sue modifiche via codice. Penso che la documentazione è troppo spesso ignorata o messa in seconda linea durante la realizzazione di un software e troppo spesso vengono rilasciate documentazioni pressochè inutilizzabili a casua delle licenze troppo poco permissive.
Con questi buoni propositi, se ti interessi di Drupal, vieni a fare un salto alla sezione Documentazione recentemente riorganizzata.
