Documentazione sulla ristrutturazione per una maggiore chiarezza

:white_check_mark: Aggiornamento (4 giugno 2024): Il lavoro iniziale di ristrutturazione degli argomenti della documentazione è stato completato e le nuove categorie sono ora attive con nuovi indici che mostrano cosa troverai al loro interno. Puoi controllarle qui: Documentation - Discourse Meta - se noti qualcosa che sembra errato, ti preghiamo di segnalarlo qui sotto!

Dopo un’attenta revisione della nostra attuale struttura di documentazione, siamo lieti di condividere che stiamo migliorando la categorizzazione della nostra documentazione per rendere gli argomenti più organizzati e focalizzati sugli obiettivi che la nostra community si prefigge di raggiungere. Il nostro obiettivo è migliorare la chiarezza e l’usabilità della nostra documentazione, rendendo più facile per tutti trovare le informazioni di cui hanno bisogno.

Cosa Aspettarsi

:label: Nuove Categorie

In futuro, la nostra documentazione sarà categorizzata e taggata in base all’azione o alla funzionalità che descrive. I raggruppamenti attuali basati sul ruolo dell’utente verranno eliminati e aggiorneremo tutti gli argomenti della documentazione per indicare quale ruolo utente è richiesto per eseguire le attività che descrivono.

:eyes: Modifiche Visive Temporanee

Durante questa ristrutturazione, potresti notare che alcune sezioni della nostra documentazione sembrano un po’ fuori posto o disorganizzate. Non preoccuparti! Questo è solo temporaneo mentre lavoriamo per finalizzare la nuova struttura.

:white_check_mark: Aggiornamenti Completi

Una volta completata la ristrutturazione, il nostro prossimo passo sarà aggiornare tutti gli argomenti della documentazione per allinearli a una nuova e comune guida di stile. Correggeremo anche eventuali inesattezze esistenti. Questo sarà un progetto in corso, con la maggior parte del lavoro svolto nelle prossime settimane.

Come Puoi Aiutare

Il tuo feedback, come sempre, è per noi prezioso. Se incontri problemi o hai suggerimenti su come possiamo migliorare ulteriormente la nostra documentazione, non esitare a condividere i tuoi pensieri in Site feedback o come post in questo argomento.

Grazie per la tua pazienza mentre apportiamo queste modifiche!

14 Mi Piace

Gli argomenti sulla moderazione come Discourse Moderation Guide fanno parte di Documentation > Site Management. Forse questo dovrebbe essere aggiunto alla descrizione perché, come moderatore, non cercherei argomenti in una categoria per “proprietari e amministratori del sito”.

3 Mi Piace

Ho apportato una piccola modifica al testo della sezione “Informazioni” per indicare che è utile anche per i moderatori.

Anche @JammyDodger e/o @hugh potrebbero avere ulteriori pensieri quando vedranno questo in seguito.

2 Mi Piace

Ho apportato una modifica aggiuntiva:

4 Mi Piace

Grazie per averlo evidenziato @Moin!

@JammyDodger Il tuo aggiornamento mi sembra buono.

Il lavoro iniziale di ristrutturazione degli argomenti della documentazione è stato completato e le nuove categorie sono ora attive con nuovi indici che mostrano cosa troverai al loro interno.

Puoi controllarli qui: Documentation - Discourse Meta - se noti qualcosa di errato, per favore rispondi qui sotto!

1 Mi Piace

Hai intenzione di aggiungere le nuove categorie al plugin docs?

1 Mi Piace

Siamo indecisi tra provare la vita senza il plugin dei documenti o meno. :slight_smile: Per ora, ho aggiunto le nuove categorie al mix. :+1:

3 Mi Piace

Un post è stato unito a un argomento esistente: Navigazione della documentazione migliorata con una nuova barra laterale

Posso sapere come viene creato il testo dei link agli argomenti nella barra laterale quando ci si trova in una sottocategoria? IA?

1 Mi Piace

Ogni sottocategoria ha un argomento indice, ad esempio: Using Discourse Index (questi sono collegati dalla descrizione nell’intestazione di ciascuna sottocategoria).

La barra laterale prende i titoli abbreviati da lì per utilizzarli invece dei titoli completi degli articoli.

3 Mi Piace