Skip to content

[docs] doc: fix stale Python version and CI references across doc/#5

Draft
github-actions[bot] wants to merge 1 commit intomainfrom
doc/consistency-fixes-2026-a7f0867540925ae2
Draft

[docs] doc: fix stale Python version and CI references across doc/#5
github-actions[bot] wants to merge 1 commit intomainfrom
doc/consistency-fixes-2026-a7f0867540925ae2

Conversation

@github-actions
Copy link
Copy Markdown

Summary

Reviewed all Markdown files under doc/ for inconsistencies with the actual source code and repository structure. Found and fixed three files where documentation still referred to Python 3.8 or 3.6 support, contradicting the real minimum requirement of Python 3.9 enforced by:

  • sdk/core/azure-core/pyproject.tomlrequires-python = ">=3.9"
  • sdk/storage/azure-storage-blobrequires-python = ">=3.9"
  • sdk/identity/azure-identity/pyproject.tomlrequires-python = ">=3.9"
  • eng/tools/azure-sdk-tools/pyproject.tomlpython_requires=">=3.9"
  • doc/tool_usage_guide.md (already correct) → "The monorepo requires a minimum of python 3.9"

Changes

doc/dev/tests.md

  • Changed "compatible with Python 3.8 and up" → 3.9 and up.
  • Removed the stale Python 3.8 Windows Store link; updated the remaining list to start at 3.9.
  • Updated the example venv path from Python38/python.exe py38_venvPython39/python.exe py39_venv.

doc/dev/packaging.md

  • Changed "Wheels must work with Python 3.8+" → 3.9+.
  • Updated the inline python_requires snippet from ">=3.8"">=3.9".
  • Removed the Programming Language :: Python :: 3.8 classifier from the full setup.py example and updated python_requires there as well.
  • In the "migrate from Python 2" checklist, updated the python_requires example to ">=3.9" and expanded the classifier removal note to include 3.7 and 3.8 (not just 3.5/3.6).

doc/dev/engineering_assumptions.md

  • Removed the stale snippet showing [bdist_wheel] universal=1 in setup.cfg — the repo is Python 3-only and the universal flag must not be set.
  • Replaced the claim that "wheels are currently generated by a CI step running Python 3.6" with accurate language: wheels are generated by CI steps running Python 3.9+.
  • Clarified that not having universal is the correct state for all packages.

Generated by Documentation Consistency Check ·

Warning

⚠️ Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • releaseassets.githubusercontent.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "releaseassets.githubusercontent.com"

See Network Configuration for more information.

- doc/dev/tests.md: update Python 3.8 references to 3.9 to match actual
  minimum requirements (azure-core, azure-identity, azure-storage-blob all
  require >=3.9, and tool_usage_guide.md states the same).
- doc/dev/packaging.md: update python_requires examples and classifiers from
  3.8 to 3.9; also expand the old-package migration note to cover the 3.7/3.8
  classifiers that should also be removed.
- doc/dev/engineering_assumptions.md: remove stale Python 3.6 CI reference
  and setup.cfg/universal flag content that no longer reflects the repo's
  Python 3-only (3.9+) stance.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions bot added automated documentation Improvements or additions to documentation labels Mar 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automated documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants