[SPARK-31513] Improve the structure of auto-generated built-in function pages in SQL references

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 3.1.0
• Component/s: Documentation, SQL
• Assignee: Unassigned
• Reporter: Takeshi Yamamuro
• Created: 22/Apr/20 00:04
• Updated: 14/Oct/20 23:25

Description

We now put examples per group in one section in the builtin function documents like this (See: SPARK-31429);

### Aggrgate Functions
<A list of aggregate functions>
#### Examples
<All examples of the aggregate functions listed above>

### Window Functions
<A list of aggregate functions>
#### Examples
<All examples of the window functions listed above>
...

But, it might be better to put everything about one function (signature, desc, examples, etc.). So, we need more discussions to improve the structure in the page.

Issue Links

• is related to: SPARK-33124 Adds a group tag in all the expressions for built-in functions
• relates to: SPARK-31429 Add additional fields in ExpressionDescription for more granular category in documentation