Skip to content

docs: Match update_cell_value and bind_task_button parameter names - #2585

Merged
schloerke merged 1 commit into
posit-dev:mainfrom
mmporong:docs-fix-param-names
Oct 29, 2026
Merged

schloerke merged 1 commit into
posit-dev:mainfrom
mmporong:docs-fix-param-names

Conversation

@mmporong

Copy link
Copy Markdown
Contributor

Two docstrings document parameters under names the functions do not take:

  • render.data_frame's update_cell_value(value, *, row, col) documents column. It also says "column index", but col accepts a column name too (the method converts a str to its index), so the entry now reads "The column index or name of the cell to update."
  • ui.bind_task_button(task=None, *, button_id) documents id; the keyword-only parameter is button_id.

Docstring-only change.

I found these by comparing the numpydoc Parameters sections under shiny/ with the function signatures. The other mismatches the scan reported are in private helpers, the Playwright controller, or bookmark.restore_input, whose id entry also describes the unresolved/resolved ID distinction. I left that one for a maintainer, since renaming it means rewording that explanation.

The docstrings documented `column` and `id`, but the parameters are
`col` (an index or a column name) and `button_id`.
@schloerke

Copy link
Copy Markdown
Collaborator

Thank you, @mmporong! Other similar doc updates are welcome!

@schloerke

Copy link
Copy Markdown
Collaborator

failures unrelated to pr. merging

@schloerke
schloerke merged commit 2020003 into posit-dev:main Oct 29, 2026
7 of 176 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants