Novas casas para documentação oficial e comunitária

Anúncios
1

Estou animado para anunciar algumas atualizações sobre como lidamos com a documentação para garantir clareza e colaboração, mantendo a qualidade das informações fornecidas. Continue lendo para entender como funciona nossa nova configuração de documentação.

:writing_hand: Documentação oficial

Atualizamos a categoria Documentation para ser dedicada exclusivamente à documentação oficial. Isso significa que todo o conteúdo em suas subcategorias é mantido por membros da equipe do Discourse, garantindo que as informações sejam precisas e atualizadas. Se você está procurando os guias e referências mais confiáveis, este é o lugar!

Por que apenas membros da equipe?

Restringir a criação e edição da documentação oficial à nossa equipe garante consistência e confiabilidade. Nosso objetivo é fornecer recursos precisos e bem mantidos para todos, desde novos usuários até desenvolvedores experientes. Todos os membros da comunidade ainda podem responder a esses tópicos para discutir o conteúdo ou sugerir alterações.

:people_hugging: Wiki da comunidade

Não se preocupe, ainda há muito espaço para suas contribuições! Toda a documentação contribuída pela comunidade agora pode ser encontrada na categoria Community wiki. É aqui que a expertise, dicas e o conhecimento coletivo de nossa vibrante comunidade se unem.

Quem pode contribuir?

Usuários com Nível de Confiança 2 e superior têm o poder de criar e editar tópicos em Community wiki. Isso capacita usuários experientes a compartilhar seu conhecimento, adicionando riqueza e diversidade aos nossos recursos comunitários. Também significa que membros confiáveis da comunidade podem editar qualquer documentação da comunidade que considerem incorreta ou desatualizada.

:question: Por que essa mudança?

Esta política foi projetada para equilibrar a necessidade de documentação oficial e mantida com a valiosa contribuição que nossa comunidade oferece. Ela também oferece uma estrutura clara para os usuários que buscam informações – seja que precisem de orientação oficial ou conselhos da comunidade.

Valorizamos as contribuições de todos vocês e acreditamos que a mudança para um espaço dedicado às suas contribuições de documentação ajudará essas contribuições a prosperar e a receber a atenção que merecem.

:derek_pointing: Precisamos de você!

A wiki da comunidade já tem um bom começo como um espaço robusto e impulsionado pela comunidade para aprendizado e compartilhamento de conhecimento, e adoraríamos mais sua contribuição. Se você tem ótimos tutoriais, configurações ou conselhos, a Community wiki aguarda suas contribuições!

Você pode encontrar esta política de documentação em sua casa permanente aqui:

10 curtidas
2

Posso saber o que acontecerá com o distintivo de Scribe?

4 curtidas
3

Existe uma maneira direta de pesquisar em ambas as fontes de documentação simultaneamente? Estou ciente de que posso pesquisar em várias categorias, mas isso é mais complicado do que simplesmente adicionar ‘Documentation’ com a ajuda do preenchimento automático.

Acho que posso usar in:docs em vez disso, porque ambas as categorias são adicionadas a ele? in:kb que também funcionou para Discourse Docs não parece funcionar.

E como funciona para subcategorias? Por exemplo, como pesquiso todas as informações escritas para usuários. Posso pesquisar em Community wiki > Users e Documentation > Using Discourse ao mesmo tempo?

5 curtidas
4

Um exemplo clássico de tag. Mas… então haveria uma quantidade tão massiva de tags que seria quase impossível gerenciar.

3 curtidas
5

O selo Scribe foi atualizado para abranger contribuições para a wiki da comunidade :slight_smile:

3 curtidas
6

Sim - você pode usar in:docs e ele pesquisará tópicos em Documentation e Community wiki ao mesmo tempo.

A pesquisa incluirá tópicos nas subcategorias, então elas já fazem parte dos resultados.

Para isso, você precisaria especificar categories:users,using-discourse na pesquisa.

2 curtidas
7

Mas todos eles precisam de um conhecimento bastante aprofundado do Discourse, pois nenhum deles é suportado na interface de pesquisa (avançada).
A documentação não deveria ser o mais fácil possível de pesquisar?

5 curtidas
10

Eu acho que isso, na verdade, destaca coisas que podemos melhorar na interface do usuário do Discourse. Notavelmente, permitir que várias categorias sejam selecionadas na pesquisa avançada, entre outras coisas.

Isso apresenta uma ótima oportunidade e motivação extra para trabalhar em atualizações como essa, então veremos o que podemos fazer lá! Discutiremos isso e voltarei aqui com quaisquer atualizações.

4 curtidas