# Qual deveria ser a página inicial para as categorias de doc?

**URL:** https://meta.discourse.org/t/what-should-the-homepage-be-for-doc-categories/398616
**Category:** UX
**Tags:** doc-categories
**Created:** [17 Março , 2026 10:30 UTC](https://meta.discourse.org/t/what-should-the-homepage-be-for-doc-categories/398616 "2026-03-17T10:30:27Z")
**Posts on this page:** 6
**Page:** 1

<div class="post-metadata">

### Author: ![mcwumbly](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/mcwumbly/32/103861_2.png) [@mcwumbly](https://meta.discourse.org/u/mcwumbly)
#### Post date: [17 Março , 2026 10:30 UTC](https://meta.discourse.org/t/what-should-the-homepage-be-for-doc-categories/398616/1 "2026-03-17T10:30:27Z")

</div>

Quando você clica em #Documentation > Site Management, eu me pergunto se deveria te levar para o [índice](https://meta.discourse.org/t/site-management-index/308032) em vez dos [tópicos mais recentes](https://meta.discourse.org/c/documentation/site-management/53/l/latest).

Ou talvez devesse te levar para algum outro tópico de “visão geral” que você especifica?

Temos vinculado diretamente ao índice nas descrições das categorias para torná-lo mais fácil de descobrir:

> **discussão relacionada**
>
> > [@manuel](#):
> >
> > > [@hellekin](#):
> > >
> > > MAS os links do “índice” do Subwiki levam a uma categoria em vez do tópico do índice (pelo menos no caso de “Developer wiki”), o que exige mais um clique para acessar os recursos de uso único onde você pode Ctrl+f.
> > 
> > É assim que as caixas de categoria padrão funcionam no momento. Provavelmente poderíamos mudar o comportamento padrão. Embora eu me pergunte qual é a experiência pretendida em nossas categorias de documentação. Parece que o índice foi adicionado com o banner da categoria em mente, em vez da caixa da categoria:
> > 
> > ![Screenshot From 2026-03-17 10-00-22](https://global.discourse-cdn.com/meta/original/4X/c/6/5/c652ba8ebc4cef4476b55e237c81151447ecf993.png)
> > 
> > Ao mesmo tempo, o tópico do índice permanece fixado no topo da lista de tópicos, ele não é desfixado automaticamente quando o tópico do índice é lido. Então estamos duplicando este índice bastante: em primeiro lugar, ele se destina a gerar o menu da barra lateral. Depois o fixamos no topo da lista de tópicos. Depois adicionamos um link a ele à descrição visível da categoria.
> > 
> > Eu acho que poderíamos realmente remover o link da descrição nas categorias de documentação.
> 
> > [@mcwumbly](#):
> >
> > > [@manuel](#):
> > >
> > > Ao mesmo tempo, o tópico do índice permanece fixado no topo da lista de tópicos, ele não é desfixado automaticamente quando o tópico do índice é lido.
> > 
> > Hmm… essa não é a minha experiência.
> > 
> > Mas sim, se estivesse funcionando assim para mim, então eu acho que veria menos necessidade para o índice aparecer nessas descrições.
> > 
> > Independentemente disso, isso deixa claro que o link é uma solução alternativa para uma lacuna de usabilidade com nosso novo plugin de docs.

Ou talvez esteja bom como está? Talvez seja redundante, visto que o índice já está na barra lateral, mas algo parece um pouco estranho no design atual de duas maneiras:

- o próprio índice pode ser difícil de encontrar
- a lista de tópicos mais recentes parece um pouco desorientadora em comparação com a forma como a navegação na documentação funciona quando você está em um determinado tópico

---

<div class="post-metadata">

### Author: ![manuel](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/manuel/32/468169_2.png) [@manuel](https://meta.discourse.org/u/manuel)
#### Post date: [17 Março , 2026 10:48 UTC](https://meta.discourse.org/t/what-should-the-homepage-be-for-doc-categories/398616/2 "2026-03-17T10:48:48Z")

</div>

Eu me pergunto se o índice oferece uma entrada melhor para a documentação. O problema que vejo é que nem a página do índice nem a barra lateral facilitam a verificação e navegação pelos tópicos da documentação:

 ![Screenshot From 2026-03-17 10-40-16](https://global.discourse-cdn.com/meta/original/4X/d/4/7/d47a0adae5c3e919fb1c7421907d4bb07c540bce.png)

 ![image](https://global.discourse-cdn.com/meta/original/4X/d/f/5/df5108fb50d5bac04657a83bcfd3389139a042df.png)

Não sei se há uma solução óbvia? Existem padrões para melhores layouts de barra lateral em plataformas de documentação existentes. Mas eles melhorariam nosso caso sem fazer mais trabalho na organização real dos tópicos? Eles podem não funcionar bem para a wiki da comunidade em geral.

Talvez uma barra lateral direita que tenha mais um layout de sumário, em vez da barra lateral esquerda estreita atual, funcionasse melhor?

---

<div class="post-metadata">

### Author: ![nickrsan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nickrsan/32/509995_2.png) [@nickrsan](https://meta.discourse.org/u/nickrsan)
#### Post date: [1 Abril , 2026 18:44 UTC](https://meta.discourse.org/t/what-should-the-homepage-be-for-doc-categories/398616/3 "2026-04-01T18:44:35Z")

</div>

Também tenho pensado nisso, independentemente do [meta.discourse.org](http://meta.discourse.org), mas como uma necessidade geral para o plugin de categorias de documentação. Acessar a página inicial é muito melhor em muitos casos e, na minha opinião, esclareceria o conteúdo da barra lateral para os usuários, em comparação com acessar diretamente a categoria e provavelmente não notar a alteração na barra lateral até entrar em um tópico.

Uma opção no plugin para habilitar isso em uma categoria seria ótima, de modo que, em casos com listas incrivelmente longas, como mencionado aqui, você possa desativá-la, mas em outros casos, possa ativá-la.

---

<div class="post-metadata">

### Author: ![nickrsan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nickrsan/32/509995_2.png) [@nickrsan](https://meta.discourse.org/u/nickrsan)
#### Post date: [2 Abril , 2026 20:12 UTC](https://meta.discourse.org/t/what-should-the-homepage-be-for-doc-categories/398616/4 "2026-04-02T20:12:14Z")

</div>

Investiguei um pouco mais isso hoje, pois estava ponderando se deveria abrir um pull request para adicionar um botão de alternância que force links diretos para a categoria a redirecionarem para o índice da documentação, e acabei encontrando uma reestruturação muito maior das funcionalidades que está em andamento: [FEATURE: Add visual doc category index editor - Pull Request #87 - discourse/discourse-doc-categories - GitHub](https://github.com/discourse/discourse-doc-categories/pull/87)

Parece ser um momento excelente para adicionar esse tipo de funcionalidade e, ao mesmo tempo, ela pode entrar em conflito com um “Modo Simples” que o @sam está desenvolvendo dentro da atualização. Sam, você vê uma possibilidade de usar o tópico de índice como a página inicial da categoria como algo que se encaixaria no seu trabalho no Modo Simples ou no trabalho mais amplo lá para oferecer mais opções de construção do índice? Seria realmente incrível poder escolher a configuração simplificada de colunas que você está desenvolvendo ou simplesmente usar o tópico de índice.

---

<div class="post-metadata">

### Author: ![mostapha](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/mostapha/32/269598_2.png) [@mostapha](https://meta.discourse.org/u/mostapha)
#### Post date: [6 Agosto , 2026 18:21 UTC](https://meta.discourse.org/t/what-should-the-homepage-be-for-doc-categories/398616/5 "2026-08-06T18:21:21Z")

</div>

Eu não estava ciente de que já existia esse pedido de funcionalidade e fiz um pedido semelhante aqui:

> [@Redirecionar a página de destino de cada subcategoria para o arquivo index por padrão nas categorias de documentação](https://meta.discourse.org/t/redirect-the-landing-page-for-each-subcategory-to-index-file-by-default-for-documentation-categories/409470):
>
> Olá, equipe do Discourse, Começamos a analisar as [Categorias de Documentos do Discourse](https://meta.discourse.org/t/discourse-doc-categories/322376). Parece muito promissor. Muito bem feito! Um ponto que notei é que a página inicial de cada subcategoria atualmente exibe uma lista de publicações dessa subcategoria, ordenadas por “Mais recentes” ou outras opções de ordenação possíveis. Embora essa seja uma abordagem aceitável para discussões, tenho a impressão de que pode confundir novos usuários que não estão familiarizados com o Discourse. Eu esperava …

Concordo que usar a página de índice seja melhor do que a página inicial atual.

> [@manuel](#):
>
> O problema que vejo é que nem a página de índice nem a barra lateral facilitam a varredura e navegação pelos tópicos da documentação:

Um recurso que já vi em outras plataformas de documentação e que está ausente na documentação do Discourse são os botões “anterior” e “próximo”, que aparecem automaticamente com base na página anterior/próxima no índice. Isso ajuda o leitor a percorrer os tópicos na ordem esperada sem precisar voltar para a página de conteúdo/índice ou usar a barra lateral. Aqui está um exemplo:

 ![image](https://global.discourse-cdn.com/meta/original/4X/e/a/9/ea94c0dd902e315cce13d530a4bbf0f70d179d39.png)

---

<div class="post-metadata">

### Author: ![jordan.vidrine](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jordan.vidrine/32/515563_2.png) [@jordan.vidrine](https://meta.discourse.org/u/jordan.vidrine)
#### Post date: [14 Agosto , 2026 13:52 UTC](https://meta.discourse.org/t/what-should-the-homepage-be-for-doc-categories/398616/6 "2026-08-14T13:52:05Z")

</div>

Concordo também que fazer o redirecionamento para a página inicial da categoria atual faz sentido. Pode até ser mais interessante exibir, por fim, uma página real com a nova interface construída a partir do índice, em vez de redirecionar para o tópico.

> [@mostapha](#):
>
> Um recurso que já vi em outras plataformas de documentação e que atualmente está faltando na documentação do Discourse são os botões «anterior» e «próximo», que aparecem automaticamente com base na página anterior ou seguinte no índice.

Essa é uma ideia realmente ótima para nossa documentação!
