Skip to content

Fix CLI link missing api_reference prefix in documentation sidebars#18893

Merged
harupy merged 2 commits intomasterfrom
copilot/fix-cli-link-api-reference
Nov 18, 2025
Merged

Fix CLI link missing api_reference prefix in documentation sidebars#18893
harupy merged 2 commits intomasterfrom
copilot/fix-cli-link-api-reference

Conversation

Copy link
Contributor

Copilot AI commented Nov 18, 2025

Related Issues/PRs

Resolves https://github.com/mlflow/mlflow/issues/xxx

What changes are proposed in this pull request?

The CLI link in both sidebar configuration files was missing the api_reference/ prefix, causing incorrect URL generation. All other API reference links (REST API, Python API, Java API, R API) correctly include this prefix.

Changes:

  • docs/sidebars.ts: Updated CLI href from cli.html to api_reference/cli.html
  • docs/sidebarsClassicML.ts: Updated CLI href from cli.html to api_reference/cli.html

This aligns with the path mapping defined in docs/scripts/update-api-modules.ts where mlflow.server.cli maps to api_reference/cli.html.

How is this PR tested?

  • Existing unit/integration tests
  • New unit/integration tests
  • Manual tests

Validated TypeScript syntax, prettier formatting, and consistency with other API reference links.

Does this PR require documentation update?

  • No. You can skip the rest of this section.
  • Yes. I've updated:
    • Examples
    • API references
    • Instructions

Release Notes

Is this a user-facing change?

  • No. You can skip the rest of this section.
  • Yes. Give a description of this change to be included in the release notes for MLflow users.

Fixed broken CLI documentation link in sidebar navigation.

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

Components

  • area/tracking: Tracking Service, tracking client APIs, autologging
  • area/models: MLmodel format, model serialization/deserialization, flavors
  • area/model-registry: Model Registry service, APIs, and the fluent client calls for Model Registry
  • area/scoring: MLflow Model server, model deployment tools, Spark UDFs
  • area/evaluation: MLflow model evaluation features, evaluation metrics, and evaluation workflows
  • area/gateway: MLflow AI Gateway client APIs, server, and third-party integrations
  • area/prompts: MLflow prompt engineering features, prompt templates, and prompt management
  • area/tracing: MLflow Tracing features, tracing APIs, and LLM tracing functionality
  • area/projects: MLproject format, project running backends
  • area/uiux: Front-end, user experience, plotting, JavaScript, JavaScript dev server
  • area/build: Build and test infrastructure for MLflow
  • area/docs: MLflow documentation pages

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
  • rn/breaking-change - The PR will be mentioned in the "Breaking Changes" section
  • rn/feature - A new user-facing feature worth mentioning in the release notes
  • rn/bug-fix - A user-facing bug fix worth mentioning in the release notes
  • rn/documentation - A user-facing documentation change worth mentioning in the release notes

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

The CLI link in the side bar is missing api_reference prefix. Fix it

href: `${apiReferencePrefix()}cli.html`,


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

@harupy harupy marked this pull request as ready for review November 18, 2025 15:39
@github-actions
Copy link
Contributor

@Copilot Thank you for the contribution! Could you fix the following issue(s)?

⚠ Invalid PR template

This PR does not appear to have been filed using the MLflow PR template. Please copy the PR template from here and fill it out.

- Fixed docs/sidebarsClassicML.ts: Changed CLI href from cli.html to api_reference/cli.html
- Fixed docs/sidebars.ts: Changed CLI href from cli.html to api_reference/cli.html
- Both CLI links now match the pattern used by REST API link

Co-authored-by: harupy <17039389+harupy@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix missing api_reference prefix in CLI link Fix CLI link missing api_reference prefix in documentation sidebars Nov 18, 2025
Copilot AI requested a review from harupy November 18, 2025 15:55
@github-actions github-actions bot added v3.6.1 area/docs Documentation issues rn/bug-fix Mention under Bug Fixes in Changelogs. labels Nov 18, 2025
@github-actions
Copy link
Contributor

Documentation preview for 0e7582e is available at:

More info
  • Ignore this comment if this PR does not change the documentation.
  • The preview is updated when a new commit is pushed to this PR.
  • This comment was created by this workflow run.
  • The documentation was built by this workflow run.

@harupy harupy merged commit 08f8f35 into master Nov 18, 2025
52 of 82 checks passed
@harupy harupy deleted the copilot/fix-cli-link-api-reference branch November 18, 2025 16:32
mprahl pushed a commit to opendatahub-io/mlflow that referenced this pull request Nov 21, 2025
…lflow#18893)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: harupy <17039389+harupy@users.noreply.github.com>
Tian-Sky-Lan pushed a commit to Tian-Sky-Lan/mlflow that referenced this pull request Nov 24, 2025
…lflow#18893)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: harupy <17039389+harupy@users.noreply.github.com>
Signed-off-by: Tian Lan <sky.blue266000@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Documentation issues rn/bug-fix Mention under Bug Fixes in Changelogs. v3.6.1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants