Skip to content

docs: quote Python extras installs under zsh (#1222) - #1568

Merged
inureyes merged 3 commits into
mainfrom
docs/issue-1222-quote-pip-extras
Sep 1, 2026
Merged

inureyes merged 3 commits into
mainfrom
docs/issue-1222-quote-pip-extras

Conversation

@inureyes

@inureyes inureyes commented Sep 1, 2026

Copy link
Copy Markdown
Member

Summary

Quote the Python extras install commands so the documented pip install ./python[dev] examples work in zsh as well as other shells.

What changed

  • Quote the development install command in python/README.md.
  • Quote the editable development install command in python/README.md's test section.
  • Quote the matching install command in docs/python-client.md.

Test plan

  • rg -n 'pip install (\.\/python\[dev\]|-e \.\/python\[dev\])' python/README.md docs/python-client.md returns no matches.
  • rg -n 'pip install ("\./python\[dev\]"|-e "\./python\[dev\]")' python/README.md docs/python-client.md finds all three documented commands.

Closes #1222

@inureyes inureyes added status:done Completed good first issue Good for newcomers type:docs Documentation improvements or additions priority:low Low priority area:docs User and developer documentation labels Sep 1, 2026
@inureyes inureyes self-assigned this Sep 1, 2026
Keep the Python README examples in Ruff's preferred fenced-code layout so the Python workflow's format check passes.

The extras-quoting fix changed only documentation, but the aligned inline comments in the fenced Python example still drifted from Ruff's formatter output. Normalize those comment columns and keep the install-command fix intact.

Validation: `python -m ruff check python`, `python -m ruff format --check python`, `python -m mypy python/src`, and `python -m pytest python/tests -m "not e2e" -q`.
@inureyes
inureyes merged commit f4ab507 into main Sep 1, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs User and developer documentation good first issue Good for newcomers priority:low Low priority status:done Completed type:docs Documentation improvements or additions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(python): quote the pip extras argument so the install commands work under zsh

1 participant