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
@inureyes
inureyes deleted the docs/issue-1222-quote-pip-extras branch October 6, 2026 12:12
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