[Parquet Metadata Cache] Document the parquet metadata cache #17048

Is your feature request related to a problem or challenge?

• Part of [Epic] Enable parquet metadata cache by default #17000

DataFusion's built in ListingTable will soon have metadata caching 🎉

I think we should make sure this feature is more discoverable via the docs

Describe the solution you'd like

Add a note to the https://docs.rs/datafusion/latest/datafusion/datasource/listing/struct.ListingTable.html that describes metadata is cached for parquet files

Add a note about the design rationale for simple algorithms, perhaps copying the text her

• feat: Limit the memory used in the file metadata cache #17031 (comment)

Describe alternatives you've considered

No response

Additional context

No response