[ARROW-15364] [Python][Doc] Update filesystem entry in read docstrings

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 8.0.0
• Component/s: Documentation, Python
• Labels: good-first-issue pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/30849
• Assignee: Raúl Cumplido
• Reporter: Joris Van den Bossche
• Created: 19/Jan/22 14:06
• Updated: 11/Jan/23 11:36
• Resolved: 05/Apr/22 08:19

Description

In several docstrings (of orc.read_table, parquet.read_table/ParquetDataset/write_to_dataset, we have something like:

filesystem : FileSystem, default None
    If nothing passed, paths assumed to be found in the local on-disk
    filesystem.

but this is actually no longer up to date. If filesystem is not specified, it will be inferred from the path, which can both be a path to local disk, or be a URI.

Issue Links

• links to: GitHub Pull Request #12787