Documentação em um fórum de discussão

Seria ótimo se você pudesse iniciar um tópico de Site feedback e elaborar um pouco sobre isso. :+1: Temos muitos sites usando uma categoria como base de conhecimento, assim como nós, e estamos sempre procurando maneiras de melhorar se você tiver alguma ideia ou feedback a oferecer.

Obrigado. Eu estava realmente me referindo apenas ao fato de que “documentos baseados em discussão” tendem a ser um trabalho árduo para novos usuários, pois muitas vezes envolve a leitura de uma postagem seguida por uma série de discussões que atualizam ou modificam a OP. Mas estou falando por mim, é claro, e posso ver que outros podem não ver dessa forma :slight_smile:

1 curtida

Sim, eu também não sou fã disso. :slight_smile: E caudas de respostas longas podem parecer assustadoras por si só. A ideia aqui (embora eu aprecie que muitas vezes há um atraso) é mover todas as informações relevantes para o OP para não ter essa situação. Também tentamos separar discussões distintas em tópicos separados (marcados, quando podemos) para torná-los mais pesquisáveis também. Também temos alguns temporizadores de exclusão automática que limpam respostas mais antigas após um certo tempo. É um trabalho em andamento, mas espero que estejamos indo na direção certa. :slight_smile:

2 curtidas

Sim. Acho que até certo ponto você não pode evitar as confusões, mas é bom saber que você está tentando (embora eu duvide que você vá tão longe a ponto de excluir comentários que foram incorporados a um OP editado posteriormente, que muitas vezes é o principal desperdício de tempo).

Mas meu ponto original não era realmente sobre isso. Acho que percebi um pouco tarde demais que você, é claro, não é um projeto F/LOSS, então pode não apreciar pessoas aleatórias como eu tentando oferecer “ajuda”.

1 curtida

Agradecemos a documentação e os conselhos criados pela comunidade. :+1:

O temporizador de exclusão automática é bastante indiscriminado, então pode ser uma faca de dois gumes. :slight_smile: Mas a intenção é destacar a sugestão de alterar a documentação em um tópico separado para reter o histórico onde necessário/útil. É um processo, hum, ‘orgânico’, então você pode encontrar alguns/muitos exemplos onde isso não aconteceu. :slight_smile:

Embora sejamos razoavelmente responsivos se você notar algo e achar que deve ser alterado/melhorado de alguma forma. :+1:

1 curtida

Não era isso a que eu estava me referindo, você olhou o link que forneci?

Eu não estava te direcionando para a categoria de documentos, /docs é gerado pelo plugin discourse docs.

A interface é bem diferente, mais parecida com um sistema típico de gerenciamento de conhecimento, com busca e filtros focados. Ele omite as respostas, que são periodicamente incorporadas à postagem original, como você pode ver nos históricos de edição.

Obrigado, mas não tenho certeza de como isso é relevante para a conversa que pensei ter iniciado, então meio que ignorei, receio. É bom saber que tal plugin existe, não me interprete mal :slight_smile:

Conforme seu comentário de que a documentação não estava em um formato adequado ou detectável, compartilhei um link para a ferramenta aqui no meta, que apresenta a documentação em um formato diferente e inclui recursos que auxiliam na detecção.

Agradeço que, vindo de uma formação de carteiro, a abordagem diferente adotada aqui pode não ser imediatamente familiar para você. Como alguém que passou grande parte dos últimos nove anos oferecendo assistência aqui no Meta, posso garantir que é incrivelmente útil ter a documentação mais próxima da discussão de suporte.

1 curtida

Entendo, desculpe, interpretei mal.

Estou perfeitamente de acordo com você fazer o que quiser. Eu estava apenas curioso para saber se você apreciaria eu enviar um PR para o repositório para adicionar instruções de instalação suplementares. Vejo que a resposta é que você não apreciaria.

Então, eu me retiro e agradeço sua indulgência :slight_smile:

1 curtida

Gosto dessa categoria #documentação e a usei com frequência. Estou confuso porque não vejo razões óbvias para que ela não seja ideal. :woman_shrugging:t2:

Há muita informação útil lá e enviar uma contribuição para lá seria apreciado e provavelmente útil para outros.