#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.
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”.
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).
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
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 .
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.
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.
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.