[Doc]: Documentation source code hyperlinks do not always point to the correct source code

[cartesian-plane]

📚 The doc issue

For example, the documenation of the generate method in LLM Class.
Clicking its source button, we find that it points to an unrelated function in utils.

This is just one example, a similar thing happens with the link for LLM.encode.

Suggest a potential alternative/fix

I am not familiar with the way Sphinx generates documentation, but there may be something to be done in one of its configs.

Before submitting a new issue...

• Make sure you already searched for relevant issues, and asked the chatbot living at the bottom right corner of the documentation page, which can answer lots of frequently asked questions.

[DarkLight1337]

cc @russellb

[chuang0221]

I think the link targets utils.py because LLM.generate, LLM.encode, etc. are wrapped by decorators that live in that module:

from vllm.utils import deprecate_args, deprecate_kwargs, deprecated
...
@deprecate(...)
def generate(...)
...

Each of those decorators returns a wrapper function defined in vllm/utils.py, so the wrapper’s module is "vllm.utils".

[russellb]

This should fix it: #17125

In my test, the new link generated for LLM.generate is: https://github.com/vllm-project/vllm/blob/main/vllm/entrypoints/llm.py#L373