Manifesto.
Perché teniamo questo blog, come lo scriviamo e cosa facciamo quando sbagliamo. L'intelligenza artificiale è parte del metodo e non lo nascondiamo.
Cinque rubriche, cinque domande
MahoCommerce si muove in fretta: ogni settimana arrivano pull request unite, release e decisioni che cambiano il modo di lavorare su un negozio. Il blog non racconta tutto, sceglie cosa conta e lo divide in cinque rubriche, ognuna pensata per una domanda precisa.
Le novità di Maho, una release alla volta: cosa cambia, cosa aggiornare e cosa leggere prima del deploy. Da ogni release partono gli Approfondimenti sulle funzionalità che meritano spazio.
Le nuove funzionalità di Maho raccontate nel dettaglio: cosa fanno, dove si usano e cosa cambia nel lavoro di ogni giorno. Le release linkano qui gli articoli che approfondiscono.
Guida utente e tutorial su MahoCommerce: come si usano le funzionalità dell'area admin e come si configura il negozio, passo per passo, con quello che serve per arrivare al risultato. Scritti per chi gestisce il negozio, non solo per chi scrive codice.
Guide tecniche per chi sviluppa su Maho: ambiente locale, temi, moduli, comandi e strumenti. Partono da un risultato che funziona e poi scendono nel codice.
Il cantiere di Maho: pull request aperte, pull request unite ma non ancora rilasciate, riepiloghi delle settimane e attività sul repository. Per chi vuole vedere cosa arriva prima che finisca in una release.
Che cosa è cambiato? È la domanda delle Novità: la nota di ogni versione, con quello che cambia e cosa guardare prima di aggiornare. Quando una funzionalità merita più spazio del paragrafo che le spetta, arriva un Approfondimento, legato alla release da cui nasce: dalla release si arriva all'approfondimento, e dall'approfondimento alla release.
Come si usa? Lo dicono le Guide, passo per passo nell'area admin. Come si costruisce? È il terreno di #Dev, tra ambienti, temi e moduli. Che cosa bolle in pentola? Lo racconta #Insider, l'unico posto dove si parla di pull request non ancora rilasciate e del lavoro sul repository.
Fuori da #Insider un articolo descrive quello che è già uscito, con la data del giorno in cui è uscito. Chi legge trova la fotografia di un prodotto, non una promessa su quello che sarà.
Fatti, opinioni, fonti
Quando c'è un fatto lo raccontiamo e linkiamo la fonte, che sia la pull request, la release o il codice; quando c'è un'opinione la scriviamo come tale. Se una cosa non è verificata lo diciamo invece di farla sembrare sicura. Quando un articolo tocca un lavoro nostro, per esempio un modulo open source o l'hosting, lo dichiariamo con il nome tecnico: chi legge deve sapere chi ha fatto cosa.
Come nasce un articolo
Ogni testo parte dalla fonte. L'intelligenza artificiale ci aiuta a leggere, riassumere e scrivere più in fretta quello che le fonti dicono; una persona controlla i fatti, i numeri, i comandi e le conclusioni prima della pubblicazione. Un testo generato e basta non viene pubblicato.
Restano comunque possibili errori: un dettaglio che cambia dopo la scrittura, una versione sbagliata, un comando rinominato nel frattempo. Se ne trovi uno, segnalalo qui sotto: correggiamo l'articolo e la data, non solo la frase.
L'AI anche nel progetto MahoCommerce
L'uso dell'AI non è un segreto nemmeno nel progetto: senza l'intelligenza artificiale un progetto come MahoCommerce non sarebbe stato possibile, e lo diciamo senza giri di parole. MahoCommerce documenta la propria trasparenza sull'uso dell'AI nel README del repository, e le pull request sviluppate con il suo aiuto lo dichiarano nella descrizione. Ogni modifica viene comunque rivista e validata da una persona prima di essere unita. Lo stesso criterio vale per questo blog: l'AI accelera il lavoro, la responsabilità resta umana.
Segnala un errore
Un errore trovato vale più di cento complimenti. Scrivi due righe qui sotto, indicando l'articolo e cosa non torna: ti rispondiamo appena possibile.
