Nuove case per la documentazione ufficiale e comunitaria

[hugh (Hugh Lashbrooke)]

Sono entusiasta di annunciare alcuni aggiornamenti su come gestiamo la documentazione per garantire chiarezza e collaborazione, mantenendo al contempo la qualità delle informazioni fornite. Continua a leggere per capire come funziona la nostra nuova configurazione della documentazione.

Documentazione ufficiale

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

Perché solo ai 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 per tutti, dai nuovi utenti agli sviluppatori esperti. Tutti i membri della community possono ancora rispondere a questi argomenti per discutere il contenuto o suggerire modifiche.

Wiki della community

Non preoccuparti, c’è molto spazio anche per i tuoi contributi! Tutta la documentazione contribuita dalla community si trova ora nella categoria Community wiki. Qui si uniscono l’esperienza, i suggerimenti e la conoscenza collettiva della nostra vibrante community.

Chi può contribuire?

Gli utenti con Livello di Fiducia 2 e superiori hanno il potere di creare e modificare argomenti in Community wiki. Ciò consente agli utenti esperti di condividere le proprie conoscenze, aggiungendo ricchezza e diversità alle nostre risorse della community. Significa anche che i membri fidati della community possono modificare qualsiasi documentazione della community che ritengono errata o obsoleta.

Perché questo cambiamento?

Questa policy è progettata per bilanciare la necessità di una documentazione ufficiale e mantenuta con il prezioso contributo che la nostra community fornisce. Offre inoltre una struttura chiara per gli utenti che cercano informazioni, sia che necessitino di una guida ufficiale o di un consiglio della community.

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

Abbiamo bisogno di te!

La wiki della community ha già un vantaggio nell’essere uno spazio robusto e guidato dalla community per l’apprendimento e la condivisione della conoscenza, e ci piacerebbe ricevere ancora più il tuo contributo. Se hai ottimi tutorial, configurazioni o consigli, Community wiki attende i tuoi contributi!

---

Puoi trovare questa policy di documentazione nella sua sede permanente qui:

Discourse documentation policy

There are two locations for Discourse documentation - one for official content, created and supported by the Discourse team, and one for community-contributed content. Official documentation Documentation is the home for official Discourse documentation. At Discourse, official documentation means the following: It is written by members of the Discourse team. It can only be edited by members of the Discourse team. It is supported by Discourse. It follows (or will be updated to follow) the doc…

[NateDhaliwal]

Posso sapere cosa succederà al badge Scribe?

[Moin]

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.

@Moin

categories:category1,category2 category:category1,category2	Restituisce i post dalle categorie category1 e category2

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?

[Jagster (Jakke Lehtonen)]

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

[hugh (Hugh Lashbrooke)]

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

[hugh (Hugh Lashbrooke)]

@Moin

Penso di poter usare in:docs invece, perché entrambe le categorie sono aggiunte a quella?

Sì, puoi usare in:docs e cercherà contemporaneamente gli argomenti in Documentation e Community wiki.

@Moin

E come funziona per le sottocategorie?

La ricerca includerà gli argomenti nelle sottocategorie, quindi fanno già parte dei risultati.

@Moin

Posso cercare contemporaneamente in Community wiki > Users e Documentation > Using Discourse?

Per fare ciò, dovresti specificare categories:users,using-discourse nella ricerca.

[Moin]

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?

[hugh (Hugh Lashbrooke)]

@Moin

tutti questi richiedono una conoscenza piuttosto approfondita di Discourse, perché nessuno di essi è supportato nell’interfaccia di ricerca (avanzata).

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.