ARROW-9021: [Python] Add the filesystem explanation to parquet.read_table docstring

[alimcmaster1]

Use same doc string as ParquetDataset. https://arrow.apache.org/docs/python/generated/pyarrow.parquet.ParquetDataset.html.

Looks like the arg currently has no docs. https://arrow.apache.org/docs/python/generated/pyarrow.parquet.read_table.html

cc. @jorisvandenbossche our discussion here: pandas-dev/pandas#34467 (comment)

[github-actions]

Thanks for opening a pull request!

Could you open an issue for this pull request on JIRA?
https://issues.apache.org/jira/browse/ARROW

Then could you also rename pull request title in the following format?

ARROW-${JIRA_ID}: [${COMPONENT}] ${SUMMARY}

See also:

• Other pull requests
• Contribution Guidelines - How to contribute patches

[jorisvandenbossche]

@alimcmaster1 thanks! I opened an issue for you: https://issues.apache.org/jira/browse/ARROW-9021 (every PR needs to have an associated issue in JIRA)

[github-actions]

https://issues.apache.org/jira/browse/ARROW-9021

[jorisvandenbossche]

@alimcmaster1 do you have an apache jira account? (or would you like to make one?) Then I can assign the issue to you for proper attribution

[alimcmaster1]

@alimcmaster1 do you have an apache jira account? (or would you like to make one?) Then I can assign the issue to you for proper attribution

Sure and thanks! I’ve just made one, username: alimcmaster1

[jorisvandenbossche]

OK, issue is updated!