Skip to content

DOC: clarify list-like conversion in DataFrame broadcasting behavior#64321

Open
LarytheLord wants to merge 2 commits intopandas-dev:mainfrom
LarytheLord:docs/clarify-listlike-broadcasting-18857
Open

DOC: clarify list-like conversion in DataFrame broadcasting behavior#64321
LarytheLord wants to merge 2 commits intopandas-dev:mainfrom
LarytheLord:docs/clarify-listlike-broadcasting-18857

Conversation

@LarytheLord
Copy link

Summary

  • clarify that list-like RHS inputs in DataFrame binary ops are converted to Series
  • document that this conversion aligns by column position
  • add a short example where list elements are ndarray objects, showing why object-valued cells can appear

Issue

Closes #18857

Notes

This is a docs-only clarification in user_guide/basics.rst under the existing "Matching / broadcasting behavior" section.

@LarytheLord
Copy link
Author

Follow-up pushed in 24f257b699 to fix docs CI: I replaced the array-of-arrays RHS example (which raises on current pandas) with a scalar list example that still demonstrates positional list-like alignment to columns.

@LarytheLord
Copy link
Author

CI note: the latest failing Doc Build and Upload run (22445955642) is failing during website context generation due an external GitHub API timeout (requests.exceptions.ConnectTimeout to api.github.com/users/TomAugspurger), not from a docs syntax/content error in this PR.

I can push/rebase if needed, but from the traceback this looks like transient network flakiness in the website build step.

@LarytheLord
Copy link
Author

CI note for Doc Build and Upload: the failing run is timing out on outbound GitHub API calls while building the website context (ConnectTimeoutError to api.github.com), which looks like transient network infra rather than this docs change. Happy to rebase/re-run if maintainers want a fresh run.

@LarytheLord
Copy link
Author

CI note: the failing Doc Build and Upload job appears unrelated to this PR content.

The failure occurs while building the website context and is a network timeout to GitHub API:

I don't have permissions to rerun workflows in this repo. If a maintainer can rerun that failed job, this should confirm whether it was transient infra/network.

@LarytheLord LarytheLord force-pushed the docs/clarify-listlike-broadcasting-18857 branch from 24f257b to d9c14b2 Compare February 28, 2026 12:21
@LarytheLord
Copy link
Author

Rebased this branch onto current main and force-pushed (d9c14b2) to retrigger a fresh doc build run after the previous GitHub API timeout. No behavioral/content change beyond the existing docs fix.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant