Navigazione della documentazione migliorata con una nuova barra laterale

Questa settimana, abbiamo pubblicato un miglioramento significativo alla documentazione di Discourse - una nuova barra laterale! Questa funzionalità è progettata per rendere la navigazione e l’accesso alla nostra documentazione più facile e intuitiva che mai.

:star2: Novità?

La nuova barra laterale viene visualizzata su tutte le categorie e gli argomenti della documentazione, rendendo più facile la navigazione dei loro contenuti. Ecco cosa puoi aspettarti:

  1. Navigazione migliorata: Con una struttura chiara e gerarchica, spostarsi tra diversi argomenti è ora più veloce e diretto.

  2. Consapevolezza del contesto: La barra laterale evidenzia gli argomenti correnti che stai visualizzando, rendendo facile capire dove ti trovi nella documentazione.

  3. Sezioni comprimibili: Ogni sezione all’interno della barra laterale può essere compressa ed espansa secondo necessità, rendendo più facile trovare gli argomenti di cui hai bisogno.

  4. Filtro live: Trova rapidamente argomenti specifici nella barra laterale digitando parole chiave pertinenti - se non viene trovato nulla, ti verrà chiesto di eseguire una ricerca più approfondita con lo stesso prompt.

  5. Mobile friendly: La nuova barra laterale funziona perfettamente su dispositivi mobili, con tutte le stesse funzionalità della visualizzazione desktop.

:eyes: Diamo un’occhiata

:boom: Puoi vedere la nuova barra laterale della documentazione in azione oggi stesso!

Ecco alcuni screenshot per darti un’idea migliore di cosa aspettarti:

Come puoi vedere, la barra laterale fornisce una chiara panoramica di tutte le sezioni della documentazione, rendendo la navigazione un gioco da ragazzi.

Ogni categoria mostra gli argomenti al suo interno, divisi in sezioni definite.

L’argomento che stai attualmente visualizzando è evidenziato nella barra laterale per un facile riferimento.

Ogni sezione può essere compressa, permettendoti di trovare più facilmente il contenuto di cui hai bisogno.

Le singole sezioni possono essere espanse per mostrare il loro contenuto più chiaramente.

:building_construction: Costruire su recenti miglioramenti

Questa nuova barra laterale fa parte dei nostri continui sforzi per migliorare l’esperienza della documentazione di Discourse. Si basa sul recente lavoro di ristrutturazione della documentazione per una maggiore chiarezza. La nuova barra laterale integra questi miglioramenti strutturali fornendo un’interfaccia intuitiva per la navigazione della documentazione ricategorizzata.

Questo è abbinato alla revisione in corso del contenuto di tutti i nostri argomenti di documentazione per allinearli alla guida di stile pubblicata di recente. Questo è un lavoro in corso e potresti notare miglioramenti graduali man mano che procediamo.

:ear: Vogliamo il tuo feedback!

Hai avuto modo di utilizzare la nuova barra laterale della documentazione? Ci piacerebbe conoscere le tue opinioni! Per favore, pubblica le tue esperienze, suggerimenti o qualsiasi domanda tu possa avere su questo argomento.

Se hai domande o feedback sui nostri sforzi complessivi di documentazione, faccelo sapere su questo argomento.

Grazie per far parte della community di Discourse. Siamo entusiasti di vedere come questa nuova funzionalità migliorerà la tua esperienza con Discourse.

22 Mi Piace

Congratulazioni per le nuove modifiche; sono davvero belle. :clap:

  • Filtro live in tutte le categorie
    So che il modo in cui funziona attualmente potrebbe essere difficile; mi sarebbe piaciuto poter filtrare indipendentemente da quali (sotto)categorie mi trovo. Questa è la prima cosa che ho provato naturalmente:

Naturalmente, ci sono link di aiuto, il che è fantastico. Invece, mi sarei aspettato:

  • Lo scorrimento del contenuto verso l’alto quando si utilizza Ctrl + /
    Quando si utilizza la scorciatoia per mettere a fuoco l’input di ricerca, scorre verso l’alto sia la barra laterale che il contenuto. Non mi aspetto che il contenuto scorra verso l’alto qui.

  • Perdita della consapevolezza del contesto
    Se si utilizza il filtro, si fa clic su un argomento e quindi si cancella il filtro, potrebbe non essere visualizzato l’argomento evidenziato. MODIFICA: Inoltre, se si naviga verso un argomento da un post.

  • La sezione collassata non viene evidenziata quando si visualizza un argomento
    Se stai visualizzando un argomento e collassando le sezioni, penso che sarebbe utile dal punto di vista del contesto evidenziare in qualche modo la sezione o semplicemente enfatizzarla.

9 Mi Piace

Bella aggiunta/miglioramento! :tada:

È molto più semplice navigare poiché è molto più ovvio dove guardare :wink:

Una piccola cosa è l’ordine delle categorie rispetto all’ordine nella barra di navigazione laterale.

In Documentation le ultime 3 categorie sono:

Documentation > Migrating to Discourse
Documentation > Contributing
Documentation > Developer Guides

Tuttavia, nella barra di navigazione laterale, Documentation > Developer Guides e Documentation > Contributing sono invertiti.

Ottimo lavoro!

4 Mi Piace

Dovrebbero essere nello stesso ordine?

Dove vedi l’ordine alternativo?

1 Mi Piace

Sono su mobile.

Che strano. Non capisco perché il tuo sia un po’ diverso. :thinking:

Ecco cosa vedo:

Inoltre, non sembra che tu abbia una descrizione della categoria della guida per sviluppatori nella casella. Hai silenziato la categoria o qualcosa del genere?

3 Mi Piace

Posso abilitare una barra laterale di categorie simile su altre istanze?

2 Mi Piace

È un Theme component GitHub - discourse/discourse-docs-sidebar.

5 Mi Piace

Ahh era quello, problema risolto! :wink:

5 Mi Piace

Sentiti libero di sperimentare, ma c’è molto altro da fare per rendere questo qualcosa che siamo preparati a supportare completamente.

C’è un bel po’ di lavoro per mantenere gli argomenti dell’indice, che è ciò che guida l’interfaccia utente della barra laterale, e nessun sistema integrato per garantire che rimangano coerenti con gli argomenti della categoria.

Per ora accettiamo questo lavoro per mantenere la documentazione qui, con l’obiettivo di raccogliere feedback dalle persone sull’esperienza di lettura e navigazione della documentazione qui. Stiamo cercando quel tipo di feedback in questo momento più che feedback su come è mantenere la documentazione utilizzando questo componente.

8 Mi Piace

Questo è davvero molto bello. Attendo con ansia una versione completa.

2 Mi Piace

È molto più facile da usare del vecchio. Più… chiaro. Ma posso scommettere che quelli più orientati tecnicamente potrebbero trovarlo limitante.

Non uso la documentazione, anche quando ne ho bisogno, perché i miei utenti temono i filtri. Questo sistema sarebbe più user-friendly.

Ma se ha bisogno di amore e cure costanti dal lato amministrativo… :thinking:

3 Mi Piace

Grazie per averli segnalati, @Arkshine! Dovrebbero essere tutti risolvibili, quindi vedremo cosa possiamo fare qui.

2 Mi Piace

In qualche modo la barra laterale della documentazione cambia il funzionamento della ricerca. Sul mio tablet, non riesco a usare il tasto Invio per ottenere i risultati della ricerca quando la barra laterale della documentazione è visibile. Ho notato che dice “next” invece di “go”, ma non so perché.

Non riesco a riprodurre il problema.

Ho appena provato sul mio iPad.

Puoi verificare se sta ancora succedendo?

Sta ancora succedendo. Posso riprodurlo in Chrome e Edge, ma non usando l’app Firefox.

Ancora, non riesco a riprodurlo. Non capisco come la barra laterale della documentazione possa causare questo.

Non altera alcun codice di ricerca.

Potrebbe essere qualcos’altro.

Puoi fornire maggiori dettagli sulla configurazione che stai utilizzando? Versione del browser, sistema operativo, ecc.

Galaxy Tab S9 FE
Android 14; SM-X510 Build/UP1A.231005.007
Chrome 126.0.6478.123

Ho provato la tastiera esterna. Questo mi ha aiutato a determinare che il tasto Invio apparentemente deve essere premuto una seconda volta.

2 Mi Piace

Ok, posso riprodurlo su Android.

Non è solo la barra laterale della documentazione, la stessa cosa accade anche con la barra laterale dell’amministratore.

Dovremo indagare sul problema.

So già cosa sta succedendo.

Discuteremo la soluzione migliore internamente.

4 Mi Piace

Il problema dovrebbe essere risolto da:

È già attivo su Meta

5 Mi Piace