Skip to content

docs: remove stale parameters from docstrings#10072

Open
eeshsaxena wants to merge 1 commit into
marimo-team:mainfrom
eeshsaxena:fix-docstring-param-names
Open

docs: remove stale parameters from docstrings#10072
eeshsaxena wants to merge 1 commit into
marimo-team:mainfrom
eeshsaxena:fix-docstring-param-names

Conversation

@eeshsaxena

Copy link
Copy Markdown

📝 Summary

Removes stale documented parameters that no longer exist in the function signatures:

File Function Stale docstring entries
marimo/_mcp/server/main.py setup_mcp_server server_name, stateless_http args + a Returns section (function returns None)
marimo/_session/notebook/serializer.py NotebookSerializer.serialize path, previous_path
marimo/_sql/utils.py convert_to_output result

Doc-only change; no behavior modified.

🔍 Description of Changes

Each docstring listed parameters left over from earlier signatures; the entries were removed so the docs match the actual arguments.

📋 Checklist

  • I have read the contributor guidelines.
  • For large changes, or changes that affect the public API: this change was discussed or approved through an issue, on Discord, or the community discussions (Please provide a link if applicable).
  • I have added tests for the changes made. (n/a - docstring-only)
  • I have run the code and verified that it works as intended. (verified against signatures)

- _mcp/server/main.py: setup_mcp_server documented `server_name` and
  `stateless_http` args (not parameters) and a stale Returns section
  (the function returns None)
- _session/notebook/serializer.py: NotebookSerializer.serialize
  documented stale `path` and `previous_path` args
- _sql/utils.py: convert_to_output documented a stale `result` arg
@vercel

vercel Bot commented Jul 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
marimo-docs Ready Ready Preview, Comment Jul 3, 2026 12:50pm

Request Review

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@eeshsaxena

Copy link
Copy Markdown
Author

I have read the CLA Document and I hereby sign the CLA

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.

1 participant