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

**URL:** https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620
**Category:** Announcements
**Tags:** documentation
**Created:** [Agosto 22, 2024, 7:09am UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620 "2024-08-22T07:09:14Z")
**Posts on this page:** 9
**Page:** 1

<div class="post-metadata">

### Author: ![hugh](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hugh/32/336717_2.png) [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [Agosto 22, 2024, 7:09am UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/1 "2024-08-22T07:09:14Z")

</div>

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.

## ✍ 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.

## 🫂 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.

## ❓ 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:

> [@Política de documentação do Discourse](https://meta.discourse.org/t/discourse-documentation-policy/322621):
>
> Existem dois locais para a documentação do Discourse: um para conteúdo oficial, criado e mantido pela equipe do Discourse, e outro para conteúdo contribuído pela comunidade. Documentação oficial O tópico #documentation é o local para a documentação oficial do Discourse. No Discourse, documentação oficial significa o seguinte: É escrita por membros da equipe do Discourse. Só pode ser editada por membros da equipe do Discourse. É mantida pelo Discourse. Segue (ou será atualizada para seguir) o…

---

<div class="post-metadata">

### Author: ![NateDhaliwal](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/natedhaliwal/32/313494_2.png) [@NateDhaliwal](https://meta.discourse.org/u/NateDhaliwal)
#### Post date: [Agosto 22, 2024, 7:12am UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/2 "2024-08-22T07:12:36Z")

</div>

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

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [Agosto 22, 2024, 7:18am UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/3 "2024-08-22T07:18:25Z")

</div>

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.

> [@Moin](#):
>
> | | |
> | --- | --- |
> | `categories:category1,category2`  
> `category:category1,category2` | Retorna posts das categorias `category1` e `category2` |

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](https://meta.discourse.org/t/discourse-docs/130172) 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?

---

<div class="post-metadata">

### Author: ![Jagster](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jagster/32/192154_2.png) [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [Agosto 22, 2024, 7:37am UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/4 "2024-08-22T07:37:06Z")

</div>

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

---

<div class="post-metadata">

### Author: ![hugh](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hugh/32/336717_2.png) [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [Agosto 22, 2024, 8:37am UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/5 "2024-08-22T08:37:22Z")

</div>

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

---

<div class="post-metadata">

### Author: ![hugh](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hugh/32/336717_2.png) [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [Agosto 22, 2024, 9:37am UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/6 "2024-08-22T09:37:21Z")

</div>

> [@Moin](#):
>
> Acho que posso usar `in:docs` no lugar, já que ambas as categorias são adicionadas a essa?

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

> [@Moin](#):
>
> E como funciona para subcategorias?

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

> [@Moin](#):
>
> Posso buscar em #community-wiki:users e #Documentation > Using Discourse ao mesmo tempo?

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

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [Agosto 22, 2024, 9:41am UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/7 "2024-08-22T09:41:56Z")

</div>

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?

---

<div class="post-metadata">

### Author: ![hugh](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hugh/32/336717_2.png) [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [Agosto 22, 2024, 11:43pm UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/10 "2024-08-22T23:43:01Z")

</div>

> [@Moin](#):
>
> todos esses exigem um conhecimento bastante aprofundado do Discourse, pois nenhum deles é suportado na interface de pesquisa (avançada).

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.

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [Maio 12, 2025, 11:47pm UTC](https://meta.discourse.org/t/new-homes-for-official-and-community-documentation/322620/11 "2025-05-12T23:47:35Z")

</div>


