A documentação do NEXTJS é ruim, ou eu sou apenas burro?

É confusa sim, eu acho.

Por exemplo, ela geralmente não coloca o import das dependências, e nem sempre são classes/tipos/... do proprio next, então é dificil adivinhar só pelas opções dadas pela IDE.

Outra coisa que confunde é porque existem dois tipos diferentes de router, o pages e o app, aparentemente sendo o app o mais recente. Quando você vai pesquisar na internet acaba encontrando soluções para o tipo errado de router.

Enfim, estou começando a trabalhar com nextjs no meu projeto de saas que até postei aqui, estou gostando mas também tive dificuldade com a documentação

Se eu entendi bem, você conseguiu entender muito bem a documentação do NestJS (backend) e não conseguiu entender muito bem a do NextJS (frontend).

Se for esse o caso, apesar de nunca ter lido a documentação do NextJS, mas de trabalhar com a documentação do NestJS sempre, eu entendo que a documentação do NestJS é muito completa e ótima.

Existem muitas documentações muito ruins, sem muito entendimento. Talvez seja esse o problema, não é uma documentação que explica muito bem, contém muitos exemplos, etc.

Mas provavelmente com StackOverflow e talvez um pouco de ChatGPT, você consiga resolver os problemas que está tendo nos estudos. Talvez até vídeos no Youtube.

Realmente é bem confusa, principalmente depois da atualização pra o 13, embora ja tivesse experiência anterior levei 3 meses pra descobrir como fazer i styled-components funcionar com o novo esquema de "use client/use server"

Ter problemas com esse tipo de tecnologia é normal, você não é burro.

Acredito que o principal problema é entender onde você está trabalhando, se é no front-end ou no back-end, porque em tecnologias como essa a front-eira é bem pequena. Minha dica é pra você pensar que está sempre trabalhando no back-end, porque de certa forma é o que acontece e também acredito que dividir os pontos em que você tá tendo dificuldade e focar em um por vez possa te fazer progredir nos teus estudos, bem é isso 👉👈

Concordo perfeitamente, eu notei isso com a chegada da versão 13, mudaram muita coisa e a documentação ficou uma zona total. Sinceramente já tentei ler algumas vezes e não tem nada claro naquela joça.

o Nextjs foi feito em cima do Reacjs. Acredito que possa ser mais eficaz ler a documentação do reactjs, pra depois tentar entender do nextjs.

Não estou a par da última atualização mas é importante entender o que é do reactjs o que é do nextjs e o que ficou obsoleto.

Do nextjs o mais importante é trabalhar com imagens, rotas e ssr.

Tente se acostumar com essas funcionalidades e depois verifique os changelogs se tem algo interessante pra tu aprimorar suas skills

Já tentou olhar o remix? Outro framework parecido com o nextjs. Talvez tenha mais sucesso.

A documentação do next, para aprender os conceitos do next e os recursos do framework eu acho muito delicinha. simples e bem explicada. Tudo q eu precisei desenvolver em um projeto do next consegui resolvendo as necessidades e problemas apenas na doc sem preicar recorrer a outras ferramentas.
Mas lembre que no next vc não irá aprender ou aprimorar react. isso fica a cargo das docs do react. no next vc irá aprender conceitos do next. Ssr, otimização do server side etc.

A doc do NextJS realmente é bem confusa, mas sobre essa parte acredito que seja pela quantidade de mudança que o NextJS recebe, acredito que eles não conseguem manter a doc atualizada, enquanto isso a documentação do NestJS foi a melhor doc que eu ja li, alem de explicar muito bem o framework, ainda ensina tópicos importantes sobre backend, aprendi muito sobre backend enquanto aprendia Nest.

Algumas assuntos são sim confusos, outros são mais detalhados. Pra começar a utilizar o framework foi bem fácil entender. Agora quando fui estudar um assunto mais complexo, como rotas dinâmicas, muita coisa não fez sentido. O ideal seria a comunidade criar uma documentação mais trabalhada e detalhada. E que seja open source, pois ai qualquer dev poderia contribuir com a documentação.

DEPENDE

No primeiro momento quando comecei a estudar, eu de fato achei bem organizada e estava dando conta de tudo que aparecia e entendendo muito bem, mas ao iniciar, na prática foi um filme de terror, 90% dos erros que eu tive da aplicação eu mal conseguia encontrar soluções por ai, e principalmente na documentação.

Sinceramente parece que nem a vercel estava pronta para mudança do Next 12 para o Next 13, parece que foi tudo feito as pressas deixando diversos pontos falhos durante a estruturação de sua documentação, principalmente para devs iniciantes (no meu caso menos de 1 ano), pouquissima explicação de pra que usar e principalmente de COMO FUNCIONA.

Alem disso também sem contar as diversas versões que em questão de 01 mês já foram lançadas quase 5 diferentes.

Você não é burro.
A documentação é excelente.
Quem nunca programou no esquema SSR se sente desconfortável no começo.
O nextjs do vercel tem 3 métodos essenciais para se entender e fazer o nextjs funcionar, e é necessário se aprofundar e praticar mesmo.
No mais você não precisa necessariamente de nextjs para fazer react modo ssr, você pode usar react puro e atingir o esquema ssr igualmente.

Partilho da mesma experiência, e realmente é meio confusa de entender, parece que na documentação não se decide o que vai usar (por exemplo explicar de forma clara o uso da pasta app/pages). Foi a primeira biblioteca que eu precisei ver um video no YouTube para explicar a documentação pela organização dela, acho que isso por o next se a prateleira para vender os produtos da Vercel.

Cara, na verdade essa questão de documentação, de certa forma, mal feita é um problema para a grande maioria das biobiotecas/frameworks ou ademais ferramentas.

Isso pode até ter mais a ver ao fato de que o programador acaba focando tanto no lado tecnico que quando vai interagir com seres humanos, parecem falar gregos kkk. Muitas vezes esquecemos que a comunicação é crucial para que nos façamos entender!
Honestamente, acredito que é o que acontece com as documentações. Focam em produtos incriveis mas esquecem da parte de se comunicar com o humano.

Pelo menos, a parte boa é que tem como sugerir mudanças na documentação, pelo menos na do Next Js