Description about the detailed param of _tasks api is not accurate

[amitmbm]

Elasticsearch Version

8.3

Installed Plugins

None

Java Version

bundled

OS Version

NA

Problem Description

Please refer the para in the get_more_information_about_tasks as shown below

You can also use the detailed request parameter to get more information about the running tasks. This is useful for telling one task from another but is more costly to execute. For example, fetching all searches using the detailed request parameter:

Here This is useful for telling one task from another but is more costly to execute seems to be incomplete, would be better if we can add a more meaningful sentence.

Steps to Reproduce

Documentation issue and provided in the Problem Description

Logs (if relevant)

NA

[elasticmachine]

Pinging @elastic/es-distributed (Team:Distributed)

[elasticmachine]

Pinging @elastic/es-docs (Team:Docs)

[DaveCTurner]

Thanks for the report @amitmbm. The sentence you mention is complete and IMO describes this parameter accurately. What extra information do you think is missing?

[amitmbm]

@DaveCTurner thanks for the super fast response but what we are trying to convey here is not complete. I think it's not complete sentence This is useful for telling one task from another ?? Does it means telling one task from another task ? and if thats the guess, than whats the telling here, what information it will tell?

[DaveCTurner]

Yes it means you can use the information to distinguish tasks from each other. It's acceptable English as written (see e.g. https://en.wiktionary.org/wiki/tell, sense 6: "To discern, notice, identify or distinguish."). The information you receive depends on the task, but docs immediately give an example.

[amitmbm]

@DaveCTurner Thanks for the link, and explaining what the meaning of tell in the given context, while I agree, its a proper english but it could be improved if we mention it explicitly like This is useful for distinguish one task from another task, this would be certainly useful for community users who are not native english speakers.

[DaveCTurner]

👍 makes sense, I think we can do that.