+1 to the general idea and thanks for driving this. I think the new structure is more clear than the old one, and i have some suggestions:
1. How about adding a "Architecture & Internals" chapter? This can help developers or users who want to contribute more to have a better understanding about Table. Essentially with blink planner, we merged a lots of codes and features but lack of proper user and design documents. 2. Add a dedicated "Hive Integration" chapter. We spend lots of effort on integrating hive, and hive integration is happened in different areas, like catalog, function and maybe ddl in the future. I think a dedicated chapter can make users who are interested in this topic easier to find the information they need. 3. Add a chapter about how to manage, monitor or tune the Table & SQL jobs, and might adding something like how to migrate old version jobs to new version in the future. Best, Kurt On Mon, Sep 2, 2019 at 4:17 PM vino yang <yanghua1...@gmail.com> wrote: > Agree with Dawid's suggestion about function. > > Having a Functions section to unify the built-in function and UDF would be > better. > > Dawid Wysakowicz <dwysakow...@apache.org> 于2019年8月30日周五 下午7:43写道： > > > +1 to the idea of restructuring the docs. > > > > My only suggestion to consider is how about moving the > > User-Defined-Extensions subpages to corresponding broader topics? > > > > Sources & Sinks >> Connect to external systems > > > > Catalogs >> Connect to external systems > > > > and then have a Functions sections with subsections: > > > > functions > > > > |- built in functions > > > > |- user defined functions > > > > > > Best, > > > > Dawid > > > > On 30/08/2019 10:59, Timo Walther wrote: > > > Hi everyone, > > > > > > the Table API & SQL documentation was already in a very good shape in > > > Flink 1.8. However, in the past it was mostly presented as an addition > > > to DataStream API. As the Table and SQL world is growing quickly, > > > stabilizes in its concepts, and is considered as another top-level API > > > and closed ecosystem, it is time to restructure the docs a little bit > > > to represent the vision of FLIP-32. > > > > > > Current state: > > > https://ci.apache.org/projects/flink/flink-docs-master/dev/table/ > > > > > > We would like to propose the following FLIP-60 for a new structure: > > > > > > https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=127405685 > > > > > > > > > Looking forward to feedback. > > > > > > Thanks, > > > > > > Timo > > > > > > > > > > > > > >
