Consente ai membri della community di suggerire modifiche ai post, dando ai revisori un controllo granulare sulle modifiche da accettare, senza concedere pieni permessi di modifica.
Il plugin è sperimentale e soggetto a molte modifiche al momento, non è ancora pronto per l’uso in produzione.
GitHub - discourse/discourse-suggested-edits: EXPERIMENTAL suggested edits plugin · GitHub
Installazione
Segui la guida standard all’installazione dei plugin utilizzando l’URL del repository:
https://github.com/discourse/discourse-suggested-edits.git
Perché le Modifiche Suggerite?
Molte community desiderano che i membri aiutino a mantenere i contenuti accurati e aggiornati, ma concedere l’accesso di modifica a tutti non è sempre pratico. Le Modifiche Suggerite colmano questa lacuna: i membri possono proporre miglioramenti ai post e i revisori fidati decidono cosa applicare. Pensala come portare un modello di contributo in stile Wikipedia nella tua community di Discourse.
Questo è particolarmente utile per:
- Categorie di knowledge base e documentazione dove l’accuratezza è importante e molti occhi aiutano
- Community con membri più nuovi che hanno buoni contributi ma non hanno ancora guadagnato la piena fiducia di modifica
- Contenuti collaborativi come FAQ, guide o riferimenti mantenuti dalla community
- Modifiche automatizzate: a volte i sistemi di intelligenza artificiale possono suggerire correzioni di refusi e di formulazione, e hai bisogno di un umano che approvi
Come Funziona
Suggerire una modifica
I membri nel gruppo di suggerimento configurato vedono un pulsante “Suggerisci Modifica” sui post idonei. Cliccandolo si apre il compositore pre-compilato con il contenuto del post. Apportano le loro modifiche, aggiungono facoltativamente una motivazione e inviano.
Revisionare i suggerimenti
I revisori vedono un badge contatore sui post con suggerimenti in sospeso. Cliccando su “Revisiona” si apre un modale che suddivide il suggerimento in modifiche individuali — ognuna mostrata come un diff evidenziato con contesto circostante.
I revisori possono:
- Accettare o rifiutare ogni modifica indipendentemente — non c’è bisogno di prendere tutto o niente
- Modificare il testo suggerito prima di applicarlo — perfezionare la formulazione preservando l’intento
- Passare tra le visualizzazioni diff inline e affiancate
- Navigare tra più suggerimenti se ce n’è più di uno in sospeso
Applicare le modifiche
Quando il revisore fa clic su “Applica Accettate”, le modifiche selezionate vengono applicate al post come una revisione attribuita a chi ha suggerito, con una motivazione di modifica che indica chi l’ha approvata. Il proponente e qualsiasi altro utente interessato vengono notificati.
Gestione della non attualità (Staleness)
Se il post originale viene modificato dopo che è stato creato un suggerimento, il suggerimento viene automaticamente contrassegnato come non attuale (stale) e non può essere applicato. Ciò previene conflitti e assicura che i suggerimenti siano sempre basati sul contenuto corrente. I proponenti vengono notificati in modo che possano risottomettere se necessario.
Configurazione
Abilita il plugin e configura l’accesso sotto Admin > Impostazioni, cercando “suggested edits” (modifiche suggerite):
| Impostazione | Descrizione |
|---|---|
suggested_edits_enabled |
Interruttore principale per il plugin |
suggested_edits_suggest_groups |
Gruppi i cui membri possono suggerire modifiche |
suggested_edits_review_groups |
Gruppi i cui membri possono rivedere e applicare i suggerimenti. Gli autori dei post possono sempre rivedere i suggerimenti sui propri post. |
suggested_edits_included_categories |
Categorie in cui le modifiche suggerite sono abilitate |
suggested_edits_included_tags |
Tag sui topic in cui le modifiche suggerite sono abilitate |
suggested_edits_max_creates_per_minute |
Limite di velocità per la creazione di suggerimenti (default: 5) |
suggested_edits_max_revisions_per_minute |
Limite di velocità per la revisione dei suggerimenti (default: 10) |
Una configurazione tipica
- Abilita il plugin
- Imposta i gruppi di suggerimento al livello di fiducia o al gruppo che dovrebbe poter proporre modifiche (es.
trust_level_1) - Imposta i gruppi di revisione ai tuoi moderatori o curatori (es.
staff) - Scegli le categorie o i tag dove vuoi che sia abilitato — non devi attivarlo ovunque
Gli autori dei post possono sempre rivedere i suggerimenti sui propri post, indipendentemente dall’impostazione del gruppo di revisione.
Ambito e Limitazioni
- Solo primi post — Le modifiche suggerite si applicano attualmente ai primi post dei topic (OP), non alle risposte
- Un solo suggerimento in sospeso per utente per post — Un membro deve attendere che il suo suggerimento corrente venga risolto prima di inviarne un altro sullo stesso post
- I suggerimenti sono basati sul testo — Il diff viene calcolato sul contenuto Markdown grezzo del post
Ricerca
I revisori possono usare il filtro di ricerca with:suggested-edits per trovare topic con suggerimenti in sospeso in tutto il forum.