Na minha opinião, este é um passo atrás em relação ao plugin original do Docs.
Discordo veementemente aqui. Ele nos dá muito mais flexibilidade na aparência de nossos documentos. Além disso, isso também possibilita o link para páginas em outras categorias e até mesmo links externos.
1 curtida
Mas com milhares de documentos e com novos sendo adicionados frequentemente, isso o torna uma tarefa muito manual.
2 curtidas
Concordo, não sei se conseguiria gerenciar documentos de 1000 páginas com o Discourse. Eu me veria fazendo isso, mesmo que existam soluções de documentação mais adequadas… 1000 páginas sem git parece… também doloroso 
Por que não? Funciona muito bem com a documentação original. Por exemplo, temos tópicos na categoria “Biblioteca” que contêm um ou mais PDFs ou outros anexos, além do texto da postagem. Cada tópico também é marcado como aplicável, então encontrar coisas é muito fácil com a pesquisa e a filtragem por tags.
Talvez seja uma questão de caso de uso. Talvez você se desenvolva para isso como resultado do uso do Discourse como documentação desde o início, mas na minha área (documentação técnica/de usuário) eu precisaria de indexação manual de qualquer maneira.
Descobri que, para o mantenedor, é muito fácil pesquisar e encontrar posts.
Mas do ponto de vista do usuário, que não conhece seu produto ou é novo no tópico, eles podem não saber o que pesquisar, nesse caso, a estruturação faz muito sentido (na minha experiência) ou os usuários se perdem no labirinto de documentação. Você pode testar isso sozinho, pense em 5 a 10 documentos aleatórios dentro de várias tags que você espera que seus usuários leiam. Em seguida, tente encontrá-los apenas clicando em seu site, se você tiver problemas para encontrá-los, pode imaginar como seria a experiência do usuário.
2 curtidas
Encontrar coisas é fácil com a filtragem. Diga que você quer instruções de instalação do motor para o modelo de aeronave Glastar. Você não sabe exatamente o que procurar, mas os conceitos são fáceis de pesquisar e filtrar:
Com a antiga documentação, tudo o que eu colocava na categoria Biblioteca era automaticamente adicionado à documentação. Não há manutenção manual de um índice separado, o que eu me oponho.
1 curtida
Concordo que o design atual não é o ideal.
Precisávamos de flexibilidade e assumimos dívida técnica para obtê-la. É o principal motivo pelo qual consideramos Discourse Doc Categories ainda como experimental.
Nossa intenção é projetar e construir algo melhor aqui um dia, mas atualmente não é uma prioridade.
5 curtidas
Acho que o problema é que o plugin original, que muitos sites adotaram e implementaram extensivamente, agora está marcado como #fim-de-vida, apesar de não oferecer uma ponte prática para o novo.
Acabei de implementar alguns KM em um site usando o novo plugin, então a experiência está fresca em minha mente. Ter que curar um tópico de índice para ver qualquer coisa na visualização de documentos parece realmente ineficaz. A implementação do plugin antigo foi comparativamente contínua, fornecendo uma taxonomia de tags decente.
Posso entender que novas necessidades impulsionaram a criação de Categorias de Documentos do Discourse, mas, por sua própria admissão, estamos presos entre um plugin experimental que não atende às necessidades atuais e o plugin antigo que tem uma vida útil finita.
7 curtidas
Concordo totalmente com o Stephen.
Fico imaginando por que isso foi abordado como um plugin totalmente novo em vez de uma evolução do original. Revoluções em software podem ser poderosas — mas funcionam melhor quando são rápidas e decisivas.
3 curtidas
Na verdade, não estou usando o plugin Docs para gerenciar a documentação — só preciso de uma interface simples para filtrar tópicos por várias categorias e várias tags ao mesmo tempo, tudo na mesma página.
A interface padrão do Discourse exige que se passe pela Pesquisa Avançada, que é muito escondida e inclui muitos filtros que não preciso (como autor ou data). Estou procurando uma experiência mais focada e direta.
O antigo plugin Docs me ajuda a alcançar essa filtragem multi-categoria e multi-tag, mas ainda tem uma limitação:
Quando seleciono uma categoria pai, ele mostra apenas tópicos diretamente dentro dessa categoria pai — ele não inclui tópicos de suas subcategorias.
Em contraste, a visualização de categoria padrão mostra tópicos de categorias pai e subcategorias.
É por isso que ainda estou usando o plugin, embora não seja o ideal.
Aqui está minha solicitação anterior relacionada a isso: Multi menu select Group tags
Obrigado novamente a todos que dedicaram tempo para discutir e ajudar a refinar isso — seu apoio e insights são profundamente apreciados.
2 curtidas