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.