Hi Martijn, Thanks for putting this together. I think it's an excellent idea, and I agree with the proposal.
Robin. On Wed, 7 Jan 2026 at 10:02, Martijn Visser <[email protected]> wrote: > Hi everyone, > > I'd like to start a discussion on FLIP-561 [1] to restructure the Apache > Flink documentation to improve discoverability and usability of them. The > Flink documentation has evolved organically over many years. While > comprehensive, users face several navigation challenges: > > - The distinction between "Try Flink", "Learn Flink", and "Concepts" is > unclear (these blur the Diátaxis categories of tutorials, explanation, and > reference) > - SQL is bundled with Table API, forcing SQL-only users through > programmatic content > - Streaming concepts like Dynamic Tables are buried in Table API, though > they are general relational streaming concepts > - Python documentation duplicates the structure of both Table API and > DataStream API > - Connector documentation is fragmented by API rather than by system > > This FLIP also refers to previously discussed and/or voted on FLIP-60 [2] > and FLIP-541 [3] > > The FLIP contains the new proposed information architecture and a couple > of screenshots from my local changes. You can also use this live website > [4] that contains mostly the refactored menu structure, content that has > been moved to a new location and some new content (like First Steps). > > I'd appreciate feedback on the proposed structure and rest of the FLIP. > > Thanks, > > Martijn > > [1] > https://cwiki.apache.org/confluence/display/FLINK/FLIP-561%3A+Restructure+Flink+documentation > [2] > https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=127405685 > [3] > https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=378473217 > [4] > https://apache-flink-doc-refactoring.netlify.app/docs/getting-started/local_installation/ > -- *Robin Moffatt* *Sr. Principal Advisor, Streaming Data Technologies*
