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

Seria ótimo se você pudesse criar um tópico em Contribute > Site feedback e elaborar um pouco mais sobre isso. :+1: Temos muitos sites usando uma categoria como base de conhecimento, inclusive nós mesmos, e estamos sempre buscando maneiras de melhorar, caso você tenha alguma ideia ou feedback para 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.