website icon indicating copy to clipboard operation
website copied to clipboard

This page jumps ahead without explaining the concepts, despite being named "Overview"

Open resnickj opened this issue 4 months ago • 1 comments

Page URL

https://docs.flutter.dev/ui/navigation/

Page source

https://github.com/flutter/website/tree/main/src/content/ui/navigation/index.md

Describe the problem

What is a route? What is deep-linking? What is a Page? Compared to most of the docs I've read so far, this page assumes a lot of prior knowledge and doesn't provide thorough, full examples.

Expected fix

Some broader explanation of the concepts and some more fleshed out examples would be really helpful.

Additional context

No response

I would like to fix this problem.

  • [ ] I will try and fix this problem on docs.flutter.dev.

resnickj avatar Aug 23 '25 19:08 resnickj

I see now that the information I was looking for is actually covered in subsequent pages (e.g. https://docs.flutter.dev/cookbook/navigation/navigation-basics), so perhaps what is really needed on the overview page is less discussion of implementation detail and better contextualization to point the reader to where they can learn about the concepts referred to.

resnickj avatar Aug 23 '25 19:08 resnickj