DOC: Clarify parentheses vs. brackets usage (GH#62314)

[AnandMukherjee2004]

• closes DOC: Clarify parentheses vs. brackets #62314
• Tests added and passed if fixing a bug or adding a new feature (N/A – docs-only)
• All code checks passed
• Added type annotations to new arguments/methods/functions (N/A – docs-only)
• Added an entry in the latest doc/source/whatsnew/vX.X.X.rst file if fixing a bug or adding a new feature (Will add if requested)

[AnandMukherjee2004]

Hi maintainers,

The CI is failing with a mypy error in pandas/io/excel/_xlsxwriter.py:
error: Argument 1 to "Workbook" has incompatible type "IO[bytes]"; expected "str | None" [arg-type]

My PR only changes documentation files and does not touch any Excel or type-related code. Could you please confirm if this mypy error is present on the main branch, and advise if I need to take any action? Thanks!

[Alvaro-Kothe]

@AnandMukherjee2004 Merge from main, this is fixed on upstream.

[AnandMukherjee2004]

All checks are passing. This PR is ready for review. Thanks!

[mroeschke]

Instead, could you just add a text-only paragraph in this section from the guide in the original issue? https://python-public-policy.afeld.me/en/columbia/brackets.html

[AnandMukherjee2004]

Instead, could you just add a text-only paragraph in this section from the guide in the original issue? https://python-public-policy.afeld.me/en/columbia/brackets.html

like should I make it more concise, and add just text para from the guide?

[mroeschke]

add just text para from the guide

Sorry I should have been more specific. Just adding a paragraph in this section with a link to https://python-public-policy.afeld.me/en/columbia/brackets.html

[AnandMukherjee2004]

add just text para from the guide

Sorry I should have been more specific. Just adding a paragraph in this section with a link to https://python-public-policy.afeld.me/en/columbia/brackets.html

All requested changes have been made. All checks are now passing, and the section contains the requested plain paragraph with a reference link. This PR is ready for further review.
Thanks!

[afeld]

/preview

[github-actions]

Website preview of this PR available at: https://pandas.pydata.org/preview/pandas-dev/pandas/62347/

[afeld]

Nice work, thank you!

[AnandMukherjee2004]

Nice work, thank you!

The documentation preview looks good, but the PR is still marked as blocked from merging.
Is there anything else you need from me to unblock it?
Thanks!

[afeld]

I think @mroeschke will need to approve and merge.

[mroeschke]

Thanks but I don't think this change requires custom HTML or a new page.

I would suggest adding a line in doc/source/getting_started/intro_tutorials/03_subset_data.rst where square brackets are first referenced that says For more explanation, see `Brackets in Python and pandas <https://python-public-policy.afeld.me/en/columbia/brackets.html>`__.

[AnandMukherjee2004]

Thanks but I don't think this change requires custom HTML or a new page.

I would suggest adding a line in doc/source/getting_started/intro_tutorials/03_subset_data.rst where square brackets are first referenced that says For more explanation, see `Brackets in Python and pandas <https://python-public-policy.afeld.me/en/columbia/brackets.html>`__.

working on it.

[mroeschke]

so should i remove this page and add the link in subset_data.rst page only?

Yes, please

[AnandMukherjee2004]

so should i remove this page and add the link in subset_data.rst page only?

Yes, please

done!! Please check and proceed!