Add table functions to function list

[colebow]

Description

Additional docs for #16716

Release notes

(x) This is not user-visible or docs only and no release notes are required.

[mosabua]

or remove () here ... and instead do a

sequence (table function)

or something like that?

[findepi]

remove ()

[kasiafi]

When () is removed, sequence TF renders different than exclude_columns TF.
I think we should keep (), and additionally add a note like (table function) for disambiguation.

So, it would be:
- :ref:sequence ( ) <sequence_table_function> (table function)

[findepi]

remove ()

[mosabua]

So how would a reader distinguish the two sequence functions by looking at this list .. dont we need to have some sort of differentiation @findepi and @colebow ?

[colebow]

I feel like the best fix for this is renaming one of the functions - having two different functions with the same name seems problematic in general.

[martint]

Scalar and table functions are in different namespaces, so we shouldn’t rename them just because they get mixed up in this list.

An alternative would be to have a separate list for table functions, or add a disambiguation parenthetical.

[mosabua]

Thats what I suggested in another comment .. and I think this is better than having the same wording twice with different links

sequencce
sequence (table function)

and only add that for table functions.. otherwise we end up with lots of (scalar function)

or we could do

sequence (scalar function, table function)

and link the ones in brackets.. but personally I think that is worse than having two lines..

[colebow]

I think I most prefer @kasiafi's suggestion here - sequence() (table function) feels the most appropriate, as it makes the function appear most similar to all other functions. I also like disambiguating the scalar function for extra clarity, so I've done that to the line above. I don't think we need to proactively disambiguate other functions on this list (or separate out other table functions) unless they share names with other functions.

[mosabua]

I like the agreed approach..