Tornar Docs mais visível no fórum?

Sou membro deste fórum há anos, mas nunca uso o Documentation - Discourse Meta porque esqueço que ele existe.

Cheguei a pensar: “seria legal se houvesse um link para Docs na navegação superior…” e então percebi que já existe um:

image

Por algum motivo, meu cérebro o ignorou completamente.

Além disso, o link na barra lateral está escondido no final do menu Mais, que eu acho (sem dados para comprovar isso) que pouquíssimas pessoas clicam.

Também me perguntei se algum ícone ao lado do botão de navegação Docs ajudaria meu cérebro a notá-lo.

image

E que tal colocá-lo ao lado do logo no cabeçalho? Talvez dois links? Um para Documentation - Discourse Meta, outro para https://docs.discourse.org/?

Além disso, algo me incomoda:

  • Docs é documentação meta
  • Discourse Docs é o plugin.
  • #docs é a tag relacionada ao plugin.
  • Os links image e image levam para Docs
  • #documentation é uma categoria não diretamente relacionada a Docs.
  • docs.discourse.org é a documentação da API.

Um pouco confuso, né?

Dito isso, o ponto principal é que sempre me esqueci que Documentation - Discourse Meta existe e, por causa disso, nunca o usei. O mais próximo que chego é usando a busca, começando com #documentation.

7 curtidas

Como um bônus adicional, você também pode usar o filtro in:docs em sua busca. :+1:

4 curtidas

Eu também!

Eu assumi que isso era uma piada. Recentemente lamentei que NÃO HAVIA COMO ENCONTRAR A DOCUMENTAÇÃO. Mas, isso não é brincadeira. Está bem ali. Claramente.

Isso também parece verdade, exceto que outro dia procurei por ele e pensei que não o encontrava lá, ou talvez eu apenas achasse que não precisava estar tão escondido.

Não tenho certeza se este é um caso de UX ou de “você pode levar um cavalo até a água”.

1 curtida

Eu acho que uma pequena parte do problema, que é algo que o @chapoi levantou em algum momento no passado, é que este menu não é realmente suposto ser um menu de navegação… é um menu de filtro ao qual adicionamos alguns links de navegação (categorias e docs).

Screenshot 2023-05-16 at 12.30.08 PM

Provavelmente faria mais sentido para os Docs ficarem na seção “community” da barra lateral, junto com outros links de navegação (não na gaveta). Isso pode torná-lo menos detectável se alguém não usar a barra lateral, então, se o link de docs precisar ser mais óbvio, também podemos destacá-lo em outro lugar :thinking:

5 curtidas

Praticamente nenhum dos meus usuários móveis comuns usa a barra lateral. Não há nada que eles sintam necessidade. E… na verdade, eu os entendo.

3 curtidas

Eu acho que este é um caso para “sim, e…”

Temos a documentação vinculada em três lugares, na verdade:

  • banner para novos usuários anônimos
  • cabeçalho do filtro no topo
  • barra lateral

Minha sugestão seria mover a documentação para “acima da dobra” na barra lateral, para que apareça abaixo de Tópicos. Também para dar a ela algum tipo de glifo de livro :open_book:.

Também para adicionar uma referência a ela em New to Discourse? Start here!, que está fixado e esperamos que as pessoas leiam ao ingressar no meta.

1 curtida

Acabei de adicionar Docs à primeira parte do menu, em Tópicos, para ver como ficaria. Gostei!

No entanto, não vejo como remover o outro link que é adicionado automaticamente ao final desta lista. Provavelmente seria necessária uma alteração no plugin para parar de exibi-lo automaticamente ou torná-lo configurável.

3 curtidas

Com desculpas pelo triplo post… Removi-o novamente da barra lateral para evitar a listagem duplicada de documentos. Estamos trabalhando em uma correção para permitir a personalização de itens da barra lateral para plugins, o que nos ajudará aqui.

1 curtida