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

Estou animado em 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 estejam precisas e atualizadas. Se você está procurando os guias e referências mais autoritativos, 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, há muito espaço para suas contribuições também! Toda a documentação contribuída pela comunidade agora pode ser encontrada na categoria Wiki. É aqui que a experiência, os dicas e o conhecimento coletivo de nossa vibrante comunidade se unem.

Quem pode contribuir?

Usuários com Nível de Confiança 2 ou superior têm o poder de criar e editar tópicos em Wiki. Isso capacita usuários experientes a compartilhar seus conhecimentos, adicionando riqueza e diversidade aos recursos de nossa comunidade. Isso 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?

Essa política foi elaborada 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 usuários que buscam informações — seja 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á elas a prosperar e receber a atenção que merecem.

:derek_pointing: Precisamos de você!

A wiki da comunidade já tem uma vantagem para se tornar um espaço robusto, impulsionado pela comunidade, para aprendizado e compartilhamento de conhecimento, e adoraríamos receber mais de suas contribuições. Se você tem ótimos tutoriais, configurações ou conselhos, o Wiki aguarda suas contribuições!


Você pode encontrar essa política de documentação em seu local permanente aqui:

10 curtidas

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

4 curtidas

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

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

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

3 curtidas

Sim — você pode usar in:docs e ele buscará tópicos em Documentation e Wiki ao mesmo tempo.

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

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

2 curtidas

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

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