Document session properties specific for the Delta Lake connector

[findinpath]

Description

Release notes

(x) This is not user-visible or docs only and no release notes are required.
( ) Release notes are required, please propose a release note for me.
( ) Release notes are required, with the following suggested text:

[mosabua]

Need to look in more detail .. but I have my doubts that it makes sense to have this list that is a mix of different topics Parquet reader, stats, ..

Why dont we just document the catalog session properties with the catalog properties they belong to? And with the relevant separate sections for different topics...

@m57lyra is working on this resstructuring for all the object storage connectors so we should sync up on how to best proceed

[findinpath]

I have my doubts that it makes sense to have this list that is a mix of different topics Parquet reader, stats, ..

If the properties are available in the session, they should appear in the documentation.
A potential Trino user shouldn't need to actually run Trino/ go through the code to discover them.

[mosabua]

I have my doubts that it makes sense to have this list that is a mix of different topics Parquet reader, stats, ..

If the properties are available in the session, they should appear in the documentation. A potential Trino user shouldn't need to actually run Trino/ go through the code to discover them.

You misunderstood me. What I am saying is we should NOT have them documented as a list of session properties for various topics. Instead we should do what we do everywhere else in the docs and document the catalog property (or global property) and the session property in the same place. So a table of Parquet config properties should list all catalog properties related to Parquet reading and writing and such .. and mention the name of the catalog session property in the same section.

Like https://trino.io/docs/current/admin/properties-query-management.html for global properties

Or https://trino.io/docs/current/connector/hudi.html#general-configuration where in fact the Parquet ones that work across connectors will be pulled out into the separate Parquet page (or fragment) .. @m57lyra is working on that

[findinpath]

Relevant commit 6eb42f2
cc @raunaqmorarka

[findinpath]

@mosabua / @m57lyra CTAL over this docs PR?