Documentazione: Consigli e trucchi su come usare la ricerca

Prima alcune meta generali :wink:

Sul mio forum ho usato un discreto numero di categorie. Principalmente perché avevo la stessa struttura su altri siti e tutti fanno lo stesso. Ma come tutti sanno, o dovrebbero sapere, un sacco di categorie e molte sottocategorie più tutte le sotto-sottocategorie sono quasi impossibili da gestire. E la parte più importante: le categorie non aiutano un utente a trovare contenuti pertinenti.

Niente di nuovo in realtà. Questo è uno dei motivi per cui Discourse supporta solo categorie a due livelli e l’uso dei tag è spesso consigliato.

Molti sono però contrari ai tag. Sostengo che porti a un ampio uso improprio dei tag su altre piattaforme, mescolandoli con parole chiave (in parte tag e parole chiave sono uguali) e all’abuso di hashtag da parte di Instagram, ecc. Inoltre… il punto di vista comune è che a causa di quella storia gli utenti comuni non sappiano come usare i tag.

Possono. Per loro, ciò che vedono sullo schermo, i tag sono la stessa cosa delle categorie, ma danno risultati migliori (SE usati correttamente dagli amministratori).

Ma i tag funzionano meglio con le ricerche. E anche questo è un problema. Poiché i tag sono ampiamente usati in modo improprio, lo sono anche le ricerche, perché semplicemente non funzionano. Gli utenti hanno imparato a non usare la ricerca, perché dà troppi risultati. È una lotta senza fine tra le capacità degli utenti, se tutti i risultati debbano essere mostrati a un utente o se possiamo usare qualche tipo di indovinello come fa Google.

Questo è un problema che gli sviluppatori devono risolvere. Ma è un’altra storia.

Comunque. Il mio pubblico sono solo persone comuni, per niente esperte di tecnologia. Hanno difficoltà ad iniziare a usare il composer di Discourse e non potevano cambiare tema. Certo, ora possono, per lo più, ma è stata necessaria molta guida.

Ma hanno accettato la mancanza di categorie e hanno iniziato subito a usare i tag. Per loro è stato un atto davvero intuitivo. O come hanno detto un paio di utenti: cliccare sui tag è come cercare, ma meglio. Tutto quello che dovevo fare a livello di guida era semplicemente dire loro di cliccare sui tag e scoprire cosa succede e dire dove Tags nell’hamburger porta.

Torniamo al lavoro

Discourse ha uno dei migliori motori di ricerca nel mondo web gratuito. Non è perfetto, ovviamente, ma è di gran lunga superiore alla ricerca nativa di WordPress o di altri CMS (se non conosci il plugin di ricerca di WordPress Relevantti, dovresti dargli un’occhiata; è abbastanza buono).

Sto insegnando ora ai miei utenti come migliorare i risultati di ricerca. In realtà, anche quello è stato un compito molto più facile di quanto mi aspettassi, e quegli utenti quasi mai usano la ricerca da nessuna parte (non li biasimo, perché le ricerche fanno spesso schifo).

Ma ora mi mancano alcuni riferimenti. So che Discourse può usare molti trucchi direttamente nei termini di ricerca, ma quei frammenti e pezzi di conoscenza sono sparsi in… molti post e argomenti.

Lo so, scrivere documentazione e consigli e trucchi richiede più lavoro che codificare in sé. Ho fatto molta documentazione. Non si tratta solo di scriverne una, ma devono esserci almeno tre documenti diversi a seconda delle esigenze e delle capacità degli utenti. Inoltre, qualcuno dovrebbe anche mantenerli aggiornati.

Ecco perché capisco totalmente di non poter trovare una guida travolgente per padroneggiare le ricerche su Discourse :wink: (o semplicemente… non riesco a cercare)

Quello che chiedo alla community è

  • un semplice elenco di (o di; a volte odio così tanto l’inglese) parametri di ricerca o semplicemente esempi/link
  • insegna ai tuoi utenti a usare la ricerca, la maggior parte di loro semplicemente non ci riesce
  • abbandona le categorie e inizia a usare i tag invece (beh, richiede un po’ di pianificazione per farlo bene, però)
6 Mi Piace

Molto d’accordo. Ci sono 2 eccellenti plugin che possono anche migliorare l’esperienza utente con le ricerche.

  • Ricerche Salvate
  • Documenti

Tuttavia, sì, impostare guide per il forum è un must assoluto per aiutare gli utenti a utilizzare meglio un forum e migliorare la loro esperienza. È qui che il plugin Documenti può sicuramente essere un vantaggio. Esiste anche un componente del tema che può essere utilizzato con il plugin Documenti.

1 Mi Piace

@hugh / @JammyDodger abbiamo bisogno di qualcosa di simile nell’argomento della documentazione?

3 Mi Piace

C’è Searching for content effectively

4 Mi Piace

Fantastico, ho integrato tutto (usando claude-3.5-sonnet) sono soddisfatto della modifica, ma sentiti libero di rivedere.

4 Mi Piace

Ho rimosso la maggior parte di essi perché:

Mi piace che l’argomento evidenzi i filtri che non riesco a scoprire utilizzando la ricerca avanzata. Se vuoi cambiare l’ambito, annulla semplicemente la modifica.

Ho lasciato le opzioni di ordinamento perché non vengono mostrate nel campo di immissione della ricerca, quindi è più difficile utilizzarle senza il menu a discesa.

1 Mi Piace

Penso che sia meglio cambiare l’ambito… questa regola sembra molto arbitraria. Forse possiamo semplicemente rimuovere "Questo argomento mira a elencare altri filtri che non sono disponibili nel modulo di ricerca avanzata"?

@JammyDodger cosa ne pensi?

Capisco che si possa scoprire molto cliccando in giro, ma la documentazione ti risparmia questo. Inoltre, questa modifica peggiora la ricerca.

Ad esempio:

tracking search non troverà più questo documento, il che è un peccato.

3 Mi Piace