Nuove case per la documentazione ufficiale e comunitaria

Sono entusiasta di annunciare alcuni aggiornamenti su come gestiamo la documentazione, per garantire chiarezza e collaborazione mantenendo alta la qualità delle informazioni fornite. Continuate a leggere per capire come funziona il nostro nuovo sistema di documentazione.

:writing_hand: Documentazione ufficiale

Abbiamo aggiornato la categoria Documentation per dedicarla esclusivamente alla documentazione ufficiale. Ciò significa che tutto il contenuto nelle sue sottocategorie è curato dai membri del team di Discourse, garantendo che le informazioni siano accurate e aggiornate. Se state cercando le guide e i riferimenti più autorevoli, questo è il posto giusto!

Perché solo i membri del team?

Limitare la creazione e la modifica della documentazione ufficiale al nostro team garantisce coerenza e affidabilità. Il nostro obiettivo è fornire risorse precise e ben mantenute a tutti, dai nuovi utenti agli sviluppatori esperti. Tutti i membri della comunità possono comunque rispondere a questi argomenti per discutere il contenuto o suggerire modifiche.

:people_hugging: Wiki della comunità

Non preoccupatevi, c’è ancora molto spazio per i vostri contributi! Tutta la documentazione contribuita dalla comunità è ora disponibile nella categoria Wiki. È qui che si riuniscono l’esperienza, i consigli e la conoscenza collettiva della nostra vivace comunità.

Chi può contribuire?

Gli utenti con Livello di Fiducia 2 o superiore hanno il potere di creare e modificare argomenti in Wiki. Questo permette agli utenti esperti di condividere le loro conoscenze, arricchendo e diversificando le risorse della nostra comunità. Significa anche che i membri fidati della comunità possono modificare qualsiasi documentazione comunitaria che ritengano errata o obsoleta.

:question: Perché questo cambiamento?

Questa politica è stata progettata per bilanciare la necessità di una documentazione ufficiale e mantenuta con il prezioso contributo che la nostra comunità offre. Fornisce inoltre una struttura chiara per gli utenti che cercano informazioni, sia che abbiano bisogno di linee guida ufficiali o di consigli della comunità.

Apprezziamo i contributi di tutti voi e crediamo che il passaggio a uno spazio dedicato per i vostri contributi alla documentazione li aiuterà a fiorire e a ricevere l’attenzione che meritano.

:derek_pointing: Abbiamo bisogno di voi!

Il wiki della comunità ha già un buon punto di partenza per diventare uno spazio robusto, guidato dalla comunità, per l’apprendimento e la condivisione delle conoscenze, e ci piacerebbe ricevere ancora più vostri contributi. Se avete ottimi tutorial, configurazioni o consigli, Wiki aspetta i vostri contributi!


Potete trovare questa politica sulla documentazione nella sua sede permanente qui:

10 Mi Piace

Posso sapere cosa succederà al badge Scribe?

4 Mi Piace

Esiste un modo semplice per cercare contemporaneamente in entrambe le origini della documentazione? Sono consapevole che posso cercare in più categorie, ma è più macchinoso che aggiungere semplicemente #documentation con l’aiuto dell’autocompletamento.

Penso di poter usare in:docs invece, perché entrambe le categorie sono aggiunte a quella? in:kb che ha funzionato anche per Discourse Docs non sembra funzionare.

E come funziona per le sottocategorie? Ad esempio, come posso cercare tutte le informazioni scritte per gli utenti? Posso cercare contemporaneamente in #community-wiki:users e #documentation:using-discourse?

5 Mi Piace

Un esempio di tag classico. Ma… ci sarebbe una tale quantità di tag che è quasi impossibile da gestire.

3 Mi Piace

Il badge Scribe è stato aggiornato per coprire i contributi alla wiki della community :slight_smile:

3 Mi Piace

Sì, puoi usare in:docs e cercherà nei topic di Documentation e Wiki contemporaneamente.

La ricerca includerà i topic delle sottocategorie, quindi questi sono già parte dei risultati.

Per farlo, dovresti specificare categories:users,using-discourse nella ricerca.

2 Mi Piace

Ma tutti questi richiedono una conoscenza piuttosto approfondita di Discourse, perché nessuno di essi è supportato nell’interfaccia di ricerca (avanzata).
La documentazione non dovrebbe essere il più facile possibile da cercare?

5 Mi Piace

Penso che questo metta in evidenza le cose che possiamo migliorare nell’interfaccia utente di Discourse. In particolare, consentire la selezione di più categorie nella ricerca avanzata, tra le altre cose.

Questa rappresenta una grande opportunità e una motivazione in più per lavorare su aggiornamenti come questo, quindi vedremo cosa possiamo fare! Ne discuteremo e tornerò qui con eventuali aggiornamenti.

4 Mi Piace