Skip to content

docs: fix broken offline inference paths in documentation#37998

Merged
DarkLight1337 merged 5 commits intovllm-project:mainfrom
vineetatiwari27:docs/fix-broken-example-paths
Mar 24, 2026
Merged

docs: fix broken offline inference paths in documentation#37998
DarkLight1337 merged 5 commits intovllm-project:mainfrom
vineetatiwari27:docs/fix-broken-example-paths

Conversation

@vineetatiwari27
Copy link
Copy Markdown
Contributor

@vineetatiwari27 vineetatiwari27 commented Mar 24, 2026

Description

A manual audit of the documentation revealed that specific files in docs/models/pooling_models/ were using incorrect relative paths to reach the examples/ directory. Additionally, these files referenced a directory structure (examples/offline_inference/basic/) that did not match the actual repository layout.

Changes

  • docs/models/pooling_models/classify.md: Updated the relative path from ../../ to ../../../ to correctly reach the root from 3 levels deep. Corrected the directory sequence from offline_inference/basic/ to basic/offline_inference/.
  • docs/models/pooling_models/embed.md: Applied the same depth and directory sequence corrections.

Testing

  • Manual Path Verification: Verified the new paths using ls from the documentation source directories:
    ls docs/models/pooling_models/../../../examples/basic/offline_inference/classify.py
  • Scope Refinement: Initially identified a wider range of files, but after manual verification, reverted changes to files (like docs/examples/README.md) where the original ../../ paths were already functionally correct.

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
@vineetatiwari27 vineetatiwari27 requested a review from noooop as a code owner March 24, 2026 11:12
@mergify
Copy link
Copy Markdown

mergify bot commented Mar 24, 2026

Documentation preview: https://vllm--37998.org.readthedocs.build/en/37998/

@mergify mergify bot added the documentation Improvements or additions to documentation label Mar 24, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request correctly updates numerous documentation files to reflect the new examples/basic/offline_inference/ directory structure. The changes are consistent and address the broken links mentioned in the description. However, I found two instances where the path update seems to have been applied incorrectly, resulting in a duplicated basic directory in the path. These appear to be oversights from an automated search-and-replace and should be corrected to ensure all links are valid.

@github-actions
Copy link
Copy Markdown

👋 Hi! Thank you for contributing to the vLLM project.

💬 Join our developer Slack at https://slack.vllm.ai to discuss your PR in #pr-reviews, coordinate on features in #feat- channels, or join special interest groups in #sig- channels.

Just a reminder: PRs would not trigger full CI run by default.

Once the PR is approved and ready to go, your PR reviewer(s) can run CI to test the changes comprehensively before merging.

To run CI, PR reviewers can either: Add ready label to the PR or enable auto-merge.

If you have any questions, please reach out to us on Slack at https://slack.vllm.ai.

🚀

vineetatiwari27 and others added 2 commits March 24, 2026 16:58
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
```bash
vllm run-batch \
-i https://raw.githubusercontent.com/vllm-project/vllm/main/examples/offline_inference/openai_batch/openai_example_batch.jsonl \
-i https://raw.githubusercontent.com/vllm-project/vllm/main/examples/basic/offline_inference/openai_batch/openai_example_batch.jsonl \
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please check the other files one by one as well

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @DarkLight1337 ,

I've refined this PR and reduced the scope to the 2 files where the broken paths were manually verified.

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
@vineetatiwari27 vineetatiwari27 force-pushed the docs/fix-broken-example-paths branch 2 times, most recently from 704733b to 415493d Compare March 24, 2026 16:13
Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
@vineetatiwari27 vineetatiwari27 force-pushed the docs/fix-broken-example-paths branch from 415493d to 3c9f2cd Compare March 24, 2026 16:52
Copy link
Copy Markdown
Member

@DarkLight1337 DarkLight1337 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks

@DarkLight1337 DarkLight1337 enabled auto-merge (squash) March 24, 2026 17:04
@DarkLight1337 DarkLight1337 added the ready ONLY add when PR is ready to merge/full CI is needed label Mar 24, 2026
@DarkLight1337 DarkLight1337 merged commit b58c5f2 into vllm-project:main Mar 24, 2026
10 of 11 checks passed
RhizoNymph pushed a commit to RhizoNymph/vllm that referenced this pull request Mar 26, 2026
…ct#37998)

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
HenryTangDev pushed a commit to HenryTangMain/vllm that referenced this pull request Mar 27, 2026
…ct#37998)

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
malaiwah pushed a commit to malaiwah/vllm that referenced this pull request Mar 27, 2026
…ct#37998)

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: Michel Belleau <michel.belleau@malaiwah.com>
khairulkabir1661 pushed a commit to khairulkabir1661/vllm that referenced this pull request Mar 27, 2026
…ct#37998)

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Monishver11 pushed a commit to Monishver11/vllm that referenced this pull request Mar 27, 2026
…ct#37998)

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: Monishver Chandrasekaran <monishverchandrasekaran@gmail.com>
nithinvc pushed a commit to nithinvc/vllm that referenced this pull request Mar 27, 2026
…ct#37998)

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Signed-off-by: Nithin Chalapathi <nithin.ch10@gmail.com>
JiantaoXu pushed a commit to JiantaoXu/vllm that referenced this pull request Mar 28, 2026
…ct#37998)

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
vrdn-23 pushed a commit to vrdn-23/vllm that referenced this pull request Mar 30, 2026
…ct#37998)

Signed-off-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Signed-off-by: Vineeta Tiwari <vineetatiwari2000@gmail.com>
Co-authored-by: Vineeta Tiwari <vineeta.tiwari2@ibm.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: Vinay Damodaran <vrdn@hey.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation ready ONLY add when PR is ready to merge/full CI is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants