Documentazione italiana

Alcuni team stanno lavorando o hanno intenzione di lavorare a breve alla propria documentazione. Tra questi ci sono sicuramente i team Theme e Community che sono già all’opera (correggetemi se sbaglio) e il team Polyglots (che dovrebbe attivarsi a breve).

A prescindere dal lavoro di ogni team, penso possa essere utile allinearsi almeno su dove caricare il materiale prodotto, per creare un unico punto di riferimento per gli utenti italiani.
A tal proposito, ho chiesto al team polyglots internazionale come i vari locale gestiscono il loro materiale (qui il post).
Riassumo di seguito le possibili opzioni raccolte finora.

  • Team
  • Pagine nel sito locale
  • Installazione locale di MediaWiki
  • Uso di HelpHub (???)
  • Uso dell’Handbook
  • Sito community separato (esempio -> sito community svedese)
  • GitHub Pages

Di seguito cosa penso dei diversi punti.

Team penso sia una scelta pessima per la documentazione. Essendo un blog i post scorrono col passare del tempo e una eventuale modifica ad un documento già online dovrebbe essere fatta dall’autore del post.

L’uso delle pagine la vedo già una soluzione migliore, ma limiterebbe il numero di persone che possono aggiungere/modifiche le pagine.

Volendo restare sul sito locale, un’installazione di MediaWiki potrebbe essere una soluzione.
O si potrebbe pensare di usare HelpHub (se possibile, è solo un’ipotesi e non ho verificato se/come sia possibile usarlo), per poter sfruttare Gutenberg per la stesura dei documenti.

L’handbook è costruito usando un plugin e consentirebbe la creazione e gestione di molte pagine.

Un’ultima alternativa potrebbe essere l’uso di GitHub Pages. GitHub permette la creazione di un sito a partire da un repository del tipo username.github.io e la creazione/modifica delle pagine diventerebbe una gestione di file su GitHub.

Pingo i diversi team leader (non vogliatemene se dimentico qualcuno)
Community -> @francina, @francescodicandia, @glorialchemica
Polyglots -> @lasacco, @wolly, @aliceorru
Supporto -> @cristianozanca
Theme -> @marialaurascarnera, @andg, @ideagrafica

@mte90 (pingato perchè sicuramente ne saprai più di me su GitHub Pages 😛 )


#documentazione