Skip to content

Conversation

@ANONYMOUSZED-beep
Copy link

This commit adds a comprehensive Python first build tutorial to address the missing documentation for Python in the Getting Started guides.

Changes:

  • Add site/en/start/python.md with complete tutorial covering:
    • Stage 1: Single target, single package (py_binary)
    • Stage 2: Multiple targets (py_binary + py_library)
    • Stage 3: Multiple packages with visibility
    • External dependencies with pip/PyPI
    • Testing with py_test
  • Update site/en/start/_index.yaml to include Python in First build guides
  • Add examples/python-tutorial/ with working example code for all stages

Fixes #27824

This commit adds a comprehensive Python first build tutorial to address
the missing documentation for Python in the Getting Started guides.

Changes:
- Add site/en/start/python.md with complete tutorial covering:
  - Stage 1: Single target, single package (py_binary)
  - Stage 2: Multiple targets (py_binary + py_library)
  - Stage 3: Multiple packages with visibility
  - External dependencies with pip/PyPI
  - Testing with py_test
- Update site/en/start/_index.yaml to include Python in First build guides
- Add examples/python-tutorial/ with working example code for all stages

Fixes bazelbuild#27824
@github-actions github-actions bot added team-Documentation Documentation improvements that cannot be directly linked to other team labels awaiting-review PR is awaiting review from an assigned reviewer labels Dec 2, 2025
@bharadwaj08-one
Copy link

@ANONYMOUSZED-beep Could you please take a look at the failing checks?

@bharadwaj08-one bharadwaj08-one added awaiting-user-response Awaiting a response from the author and removed awaiting-review PR is awaiting review from an assigned reviewer labels Dec 2, 2025
@iancha1992 iancha1992 added the team-Rules-Python Native rules for Python label Dec 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting-user-response Awaiting a response from the author team-Documentation Documentation improvements that cannot be directly linked to other team labels team-Rules-Python Native rules for Python

Projects

None yet

Development

Successfully merging this pull request may close these issues.

No first build guide is present for Python in https://bazel.build/start

3 participants