Hi dylanhz, Thanks for the feedback and the +1. No I don't think we need the Scala tab. During the restructuring I will keep an eye out to remove it.
@Xiqian I have added a new screenshot of the page with all the functions listed. Cheers, Ramin On Thu, Oct 29, 2026 at 8:20 AM dylanhz <[email protected]> wrote: > Hi Ramin, > > A strong +1 from me! More detailed, consistently structured docs would be > easier for both human readers and AI agents to understand. > > One small question: since the Scala APIs are deprecated, do we still need > the Scala syntax tab? > > Thanks! > > > ---------- > Best regards, > dylanhz > > > > > > 2026年10月28日 21:57，Ramin Gharib <[email protected]> 写道： > > > > Hi all, > > > > I'd like to restructure the built-in functions page [1]. It lists 306 > > functions and operators as table rows on a single page, each with a > > free-form description. Arguments, return values, NULL behavior and errors > > are hard to find. > > > > The proposal picks up FLINK-23804 [2]: > > - Each function gets its own page with the same sections: syntax for SQL > > and the Table API, arguments, returns, usage notes and examples. > > - The sidebar groups the function pages by category, and each category > > folds open and closed. > > > > The screenshots [3] show REGEXP_EXTRACT and the sidebar in the new > layout, > > built locally with the current docs theme. > > > > I'd move one category per PR. Moving the existing entries is mostly > > mechanical, so I'd use AI assistance and fill in the AI disclosure in the > > PR template. > > > > I would be interested in your feedback on this idea. > > > > Cheers, > > Ramin > > > > [1] > > > https://nightlies.apache.org/flink/flink-docs-release-2.4/docs/sql/functions/built-in-functions/ > > [2] https://issues.apache.org/jira/browse/FLINK-23804 > > [3] > https://drive.google.com/drive/folders/123rKBt0ESz5Wn5VSlCcQF3hxJuwtf3Q9 > >
