Skip to content

Auto-update API inventory in autoformat workflow#19157

Merged
harupy merged 3 commits intomasterfrom
copilot/update-api-inventory-docs
Dec 2, 2025
Merged

Auto-update API inventory in autoformat workflow#19157
harupy merged 3 commits intomasterfrom
copilot/update-api-inventory-docs

Conversation

Copy link
Contributor

Copilot AI commented Dec 2, 2025

What changes are proposed in this pull request?

Automatically regenerates docs/api_reference/api_inventory.txt during autoformat when Python APIs or RST docs change.

Changes:

  • Detects modifications to mlflow/**/*.py or docs/api_reference/**/*.rst
  • Runs uv run --group docs --extra gateway --directory docs/api_reference make dummy to regenerate inventory
  • Uses dummy builder for speed (parses docs, triggers inventory generation, skips HTML output)

How is this PR tested?

  • Manual tests

Verified:

  • Pattern matching correctly identifies API-related files
  • make dummy successfully generates api_inventory.txt (~90s execution)
  • YAML syntax valid, security scan clean

Does this PR require documentation update?

  • No. You can skip the rest of this section.

Release Notes

Is this a user-facing change?

  • No. You can skip the rest of this section.

What component(s), interfaces, languages, and integrations does this PR affect?

Components

  • area/build: Build and test infrastructure for MLflow

How should the PR be classified in the release notes? Choose one:

  • rn/none - No description will be included. The PR will be mentioned only by the PR number in the "Small Bugfixes and Documentation Updates" section

Should this PR be included in the next patch release?

  • Yes (this PR will be cherry-picked and included in the next patch release)
  • No (this PR will be included in the next minor release)
Original prompt

Run uv run --group docs --extra gateway --directory docs/api_reference make rsthtml in autoformat.yml to update docs/api_reference/api_inventory.txt if the PR diff contains changes in mlflow/**/*.py or docs/api_reference/**/*.rst


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@harupy harupy marked this pull request as ready for review December 2, 2025 08:44
Copilot AI and others added 2 commits December 2, 2025 08:52
- Add detection for changes in mlflow/**/*.py or docs/api_reference/**/*.rst
- Run `uv run --group docs --extra gateway --directory docs/api_reference make rsthtml` when API-related files change
- This will automatically update docs/api_reference/api_inventory.txt during autoformat

Co-authored-by: harupy <17039389+harupy@users.noreply.github.com>
The dummy target still runs Sphinx build and triggers env-updated event to generate api_inventory.txt, but skips HTML generation for faster execution.

Co-authored-by: harupy <17039389+harupy@users.noreply.github.com>
Copilot AI changed the title [WIP] Update api_inventory.txt based on changes in documentation Auto-update API inventory in autoformat workflow Dec 2, 2025
Copilot AI requested a review from harupy December 2, 2025 09:01
@github-actions github-actions bot added area/build Build and test infrastructure for MLflow rn/none List under Small Changes in Changelogs. labels Dec 2, 2025
@harupy harupy enabled auto-merge December 2, 2025 09:32
@harupy harupy added this pull request to the merge queue Dec 2, 2025
Merged via the queue into master with commit 8e3fb7d Dec 2, 2025
49 of 51 checks passed
@harupy harupy deleted the copilot/update-api-inventory-docs branch December 2, 2025 09:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/build Build and test infrastructure for MLflow rn/none List under Small Changes in Changelogs.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants