feature request: attach a `reason` parameter to `@nodiscard`

[!NOTE]
I couldn't find an issue for this. sorry if there's a duplicate.

I propose updating the @nodiscard annotation to add a "reason" as to why not discard the value:

---@nodiscard [<reason>]

this would mirror Rust's #[must_use = "reason"] annotation.

example:

---Creates a new class that inherits from this one.
---@return Class
---@nodiscard This method returns the new class; it's pointless to immediately discard it.
function Object:extend()
  -- ...
end

discarding the output would then display the warning:

* [warning][Lua Diagnostics.][discard-returns]
  The return values of this function cannot be discarded:
  This method returns the new class; it's pointless to immediately discard it.

note the colon at the end of "discarded".
if not given a reason, it would fall-back to the usual message, with "discarded" ending with a dot and no further explanation
(yes, I'm aware that reason in the Object:extend example isn't exactly... professional 😅)

Aucun fichier ni test n’est nommé. Commencez par localiser l’analyseur de l’annotation @nodiscard et le diagnostic discard-returns, puis suivez la manière dont le texte de l’annotation parvient à cet avertissement. C’est terminé lorsqu’une raison fournie est affichée avec la ponctuation en deux-points demandée, tandis qu’une raison omise conserve le message et le point existants.