Vai al contenuto
Home / Blog / Manifesto

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.

  • Novità

    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.

  • Approfondimenti

    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.

  • Guide

    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.

  • #Dev

    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.

  • #Insider

    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.

Ti rispondiamo solo se serve un chiarimento.

Grazie, abbiamo ricevuto la segnalazione.