Skip to content

refactor(python): readme improvements - #3825

Open
mmmmxa wants to merge 3 commits into
apache:masterfrom
mmmmxa:refactor/python-readme-improvements
Open

refactor(python): readme improvements#3825
mmmmxa wants to merge 3 commits into
apache:masterfrom
mmmmxa:refactor/python-readme-improvements

Conversation

@mmmmxa

@mmmmxa mmmmxa commented Aug 5, 2026

Copy link
Copy Markdown

Which issue does this PR address?

Closes #3750

Rationale

The documentation provided in Python SDK does not provide a golden path for development workflow. The absence of golden path adds the cognitive load on most devs, especially the new ones.

What changed?

README for Python SDK now provides a clear instruction on how to build and test it and gives basic advice on troubleshooting for precommit and prepush hooks. The new path is tested by hand and has fixed a number of unwanted side effects described in the linked issue.

Local Execution

  • Passed
  • Pre-commit hooks ran

AI Usage

If AI tools were used, please answer:

  1. Which tools? - Claude
  2. Scope of usage? - autocomplete, editing
  3. How did you verify the generated code works correctly? - ran the proposed workflows from the readme manually on my local computer
  4. Can you explain every line of the code if asked? - yes

@mmmmxa
mmmmxa marked this pull request as ready for review August 5, 2026 17:20
@github-actions github-actions Bot added the S-waiting-on-review PR is waiting on a reviewer label Aug 5, 2026
@mmmmxa

mmmmxa commented Aug 5, 2026

Copy link
Copy Markdown
Author

/ready

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

Labels

S-waiting-on-review PR is waiting on a reviewer

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Python SDK: Developer Experience and Development Environment Improvements

1 participant