aljoscha opened a new pull request #11092: [FLINK-15999] Extract “Concepts” material from API/Library sections and start proper concepts section URL: https://github.com/apache/flink/pull/11092 This is the second phase of https://cwiki.apache.org/confluence/display/FLINK/FLIP-42%3A+Rework+Flink+Documentation. The first few comments are preliminary refactorings of the doc that are also in separate PRs. You can also review them here if you want. The commits describe how the sections are moved around and when they are adapted/fixed. The general idea is that all concept-y material is extracted from individual sections and moved to the concepts section. On the way, some duplicate material was dropped and I fixed outdated references/naming. I also changed all links to use the `{{ site.baseurl }}{% link dev/bar/baz/doc.md %}` format which has detection of missing links built in. I added `TODO: ...` entries in various places in the concepts sections to mark what still needs to be done. I think leaving them in for now is better than what we had before as a concepts section, I would create Jira Issues for those and try and spread the work. At the latest before the next release those should be removed. Reviewing this PR is probably easiest by checking it out and reading the concepts sections.
---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org With regards, Apache Git Services
