Introduzione alle Modifiche Imminenti, un sistema per gestire nuove funzionalità e cambiamenti alla funzionalità esistente nella tua community

Mentre continuiamo a migliorare Discourse, abbiamo creato una nuova pagina di configurazione “Modifiche imminenti” (Upcoming Changes) per aiutare gli amministratori a comprendere quali modifiche stanno arrivando in Discourse e consentire loro di gestire come tali modifiche vengono implementate nella loro community. Riteniamo che questo sistema ci aiuterà a continuare a migliorare Discourse in modo sicuro e trasparente.

In questo argomento, spiegheremo come funziona questo nuovo sistema e come utilizzarlo per introdurre in modo sicuro nuove funzionalità e altre modifiche nella tua community.

Panoramica di come funziona Modifiche imminenti

Mentre lavoriamo su nuove funzionalità o altre modifiche, le aggiungeremo alla pagina di configurazione Modifiche imminenti all’indirizzo /admin/config/upcoming-changes. Ogni modifica includerà una descrizione, uno stato, un indicatore degli utenti interessati da essa e per quali utenti (se presenti) è abilitata nella tua community.

A seconda dello stato della modifica, puoi decidere se attivarla o disattivarla per la tua community, almeno temporaneamente, poiché alcune modifiche verranno eventualmente attivate in modo permanente.

Disabilitare temporaneamente una modifica ti dà il tempo di affrontare eventuali personalizzazioni del sito interessate, processi e così via, informare la tua base di membri sulla modifica o delegare determinati gruppi di membri per i test.

Analisi di una modifica imminente

Analizziamo una modifica imminente e definiamo le informazioni che vedrai in ogni sezione.

1 - Nome e descrizione

Il nome e la descrizione ti forniscono una breve spiegazione della modifica e spesso includeranno collegamenti a contenuti correlati (come un argomento su Meta) per ulteriori dettagli.

2 - Stato

Lo stato comunica la sua posizione nel ciclo di vita dello sviluppo. Lo stato influisce direttamente sul fatto che la modifica sia opt-in (cioè disattivata per impostazione predefinita, ma puoi attivarla), opt-out (cioè attivata per impostazione predefinita, ma puoi disattivarla) o forzata (cioè attiva e non puoi disattivarla).

Utilizziamo i seguenti stati in Modifiche imminenti:

  • Sperimentale (Experimental): Una potenziale modifica che è in fase iniziale di sviluppo/test ed è prevista evolvere rapidamente, o potrebbe essere rimossa del tutto se interrompiamo l’esperimento (a quel punto passerà allo stato Inattivo; vedi sotto). Puoi attivare le modifiche Sperimentali per provarle.
  • Alpha: Una modifica testata che è sicura da usare, anche se potrebbero esserci alcuni piccoli aggiornamenti al suo design o alla sua funzionalità. Puoi attivare le modifiche Alpha per usarle in anticipo.
  • Beta: Una modifica testata che è sicura da usare ed è improbabile che cambi molto prima di passare allo stato Stabile o possibilmente Permanente. Per la maggior parte dei siti, le modifiche Beta vengono attivate automaticamente per tutti (se non le hai abilitate in precedenza), ma puoi comunque disattivare l’opzione.
  • Stabile (Stable): Una modifica completata[1], ma è ancora opt-out (cioè gli amministratori possono disabilitarla). Gli amministratori riceveranno un avviso sulla loro dashboard se hanno disattivato una modifica Stabile.
  • Permanente (Permanent): Una modifica che ha completato i test ed è forzata attiva (cioè gli amministratori non possono disabilitarla).
  • Inattivo (Inactive): Un esperimento abbandonato. Non puoi attivare l’opzione.

A volte, le modifiche progrediranno linearmente attraverso questi stati (cioè inizieranno in Sperimentale e finiranno in Permanente), ma non sempre. Alcune modifiche possono essere introdotte nello stato Alpha o Beta, e alcune finiranno nello stato Stabile (se non verranno forzate attive).

Non c’è un tempo stabilito per quanto tempo impiegherà una particolare modifica per passare da uno stato all’altro, ma gli amministratori verranno avvisati quando:

  • Una nuova modifica è disponibile da provare
  • Una modifica è stata abilitata automaticamente
  • Quando hai disabilitato una modifica che sarà presto forzata attiva

3 - Utenti interessati

L’etichetta Utenti interessati descrive quali utenti nella tua community possono vedere o interagire con la modifica in qualche modo. Per dirla semplicemente: chi potrebbe notare questa modifica? Ci sono diversi tipi di utenti interessati:

  • Amministratori (Admins): La modifica è visibile solo agli amministratori.
  • Staff: La modifica è visibile solo agli amministratori e ai moderatori.
  • Tutti i membri (All members): La modifica è visibile a tutti i membri del tuo sito.
  • Sviluppatori (Developers): In rari casi, una modifica sarà notevole solo per coloro che interagiscono con il codice nel core, nei temi o nei plugin.

4 - Abilitato per…

Questo menu a discesa è dove tu, come amministratore del sito, puoi controllare se e come introdurre questa modifica nella tua community abilitandola per:

  • Nessuno (No one): Disabilita la modifica per tutti sul sito.
  • Tutti (Everyone): Abilita la modifica per tutti sul sito, inclusi gli utenti anonimi. Quando la modifica viene attivata automaticamente (tipicamente allo stato Beta), sarà per Tutti.
  • Solo staff (Staff only): Abilita la modifica per lo staff del sito (cioè amministratori e moderatori).
  • Gruppi specifici (Specific groups): Abilita la modifica per i gruppi selezionati.

Per ora, abbiamo spostato la maggior parte delle modifiche Sperimentali da /admin/config/experimental in Modifiche imminenti, e inizierai a vedere nuovi aggiornamenti arrivare qui presto. Non vediamo l’ora di conoscere l’impatto che questo avrà sulla tua community e siamo aperti a qualsiasi domanda o feedback!


  1. Per quanto un software possa essere completo! ↩︎

17 Mi Piace

Sono curioso: come controlla la distribuzione della modifica? Può essere modificata dopo l’introduzione della funzionalità? Grazie.

1 Mi Piace

Native Feature Flags! Molto bene :clap:

Sarebbe fantastico avere un’API per i plugin.

1 Mi Piace

È una funzionalità a lungo attesa! Grazie!

1 Mi Piace

Questo è fantastico, avere la possibilità di cambiare le bandiere in questo modo è incredibile per le persone all’avanguardia come me, specialmente quando si sviluppa un tema

Tuttavia, “modifiche imminenti” è davvero il nome migliore per questo? Ad esempio, HomeAssistant usa “labs” e molte altre persone usano cose come “esperimenti” che sembrano migliori di modifiche imminenti.

Riceverai una notifica delle nuove funzionalità mentre sono ancora in uno stato in cui puoi provarle in anticipo (opt-in) e disattivarle temporaneamente per risolvere eventuali problemi causati dalla modifica (opt-out). Se una modifica diventerà permanente (il che significa che non puoi disattivare l’opzione) e l’hai attualmente disattivata, te lo faremo sapere.

Questa sezione lo descrive con qualche dettaglio in più:

Al momento, stai vedendo solo modifiche sperimentali perché le abbiamo migrate dall’area impostazioni a Modifiche imminenti, ma in futuro ci saranno anche aggiornamenti non sperimentali qui. Quindi “laboratori” non sembra accurato per come stiamo utilizzando questo sistema.

1 Mi Piace