Documentation for Location Providers

[smaheshwar-pltr]

Feature Request / Improvement

Following #1452, we want to add documentation for the new location providers; it introduces a new PyIceberg-specific table property, and location providers are user-specifiable. Quoting #1452 (review):

I think we should document:

LocationProvider
	SimpleLocationProvider
	ObjectStoreLocationProvider
Loading a Custom LocationProvider

And new table properties:

WRITE_PY_LOCATION_PROVIDER_IMPL = "write.py-location-provider.impl"

OBJECT_STORE_ENABLED = "write.object-storage.enabled"
OBJECT_STORE_ENABLED_DEFAULT = False

WRITE_OBJECT_STORE_PARTITIONED_PATHS = "write.object-storage.partitioned-paths"
WRITE_OBJECT_STORE_PARTITIONED_PATHS_DEFAULT = True

(Although to note that some defaults might change in #1509)

[smaheshwar-pltr]

Happy to pick this up, just dropping an issue for now.

I'd like to wait for #1509 to merge before merging this (can still start on the docs) so we have an idea of defaults.

There's an argument to wait for #1492 because write.data.path does change the code significantly. But IMHO, if we keep the docs fairly high-level similar to the Java-side (which I think we should anyway), this won't be an issue and they won't need to be changed. Update: See #1537 (comment).