DOC: Document use of `use_arrow=True` for faster IO

[kylebarron]

A quick draft for https://github.com/geopandas/geopandas/issues/3386

[m-richards]

I'm getting deja vu writing this but I can't seem to find the thread, would it make sense for us to have a geopandas.options.io_engine='pyogrio_arrow' or similar in addition to the environment variable?

[kylebarron]

What do you think about that edit?

[theroggy]

General remark: might be purely personal, but I've only read/scanned the user manual once a few years ago when I started to use geopandas. When I want to find information about a function I go look in the documentation of that function rather than the user manual.

Maybe it is useful to add one sentence in the read_file documentation/notes that there are options to improve performance + a link "more information can be found here"?

[martinfleis]

Maybe it is useful to add one sentence in the read_file documentation/notes that there are options to improve performance + a link "more information can be found here"?

+1

[m-richards]

Just pushed a commit with the two suggested additional comments, hopefully I've got the relative paths right referencing the docs.

[m-richards]

test failure is for folium and is unrelated

[kylebarron]

Thanks for pushing this over the line!