[FLINK-22958] Reused content in docs causes confusing navigation jumps

• Type: Improvement
• Status: Open
• Priority: Minor
• Resolution: Unresolved
• Affects Version/s: 1.13.1
• Component/s: Documentation
• Assignee: Unassigned
• Reporter: Ingo Bürk
• Created: 10/Jun/21 06:21
• Updated: 10/Jun/21 06:21

Description

If you go to the PyFlink documentation (e.g. https://ci.apache.org/projects/flink/flink-docs-master/docs/dev/python/overview/), you can see Table API > System Built-In Functions nested in there. If you now navigate to this page, you're suddenly no longer under "Python API" but "Table API & SQL", because this page is nested under both API docs and apparently the routing isn't as independent as it seems (and should be).

This is very confusing since it throws you entirely out of context.