fix: 📝 Add missing docs to .respond methods

[ToothyDev]

Summary

Previously, the possible parameters for both Interaction.respond and ApplicationContext.respond (which copied its docs) weren't documented, this is now the case

Information

• This PR fixes an issue.
• This PR adds something new (e.g. new method or parameters).
• This PR is a breaking change (e.g. methods or parameters removed/renamed).
• This PR is not a code change (e.g. documentation, README, typehinting,
  examples, ...).

Checklist

• I have searched the open pull requests for duplicates.
• If code changes were made then they have been tested.
  • I have updated the documentation to reflect the changes.
• If type: ignore comments were used, a comment is also left explaining why.
• I have updated the changelog to include these changes.

[pycord-app]

Thanks for opening this pull request!
Please make sure you have read the Contributing Guidelines and Code of Conduct.

This pull request can be checked-out with:

git fetch origin pull/3061/head:pr-3061
git checkout pr-3061

This pull request can be installed with:

pip install git+https://github.com/Pycord-Development/pycord@refs/pull/3061/head

[ToothyDev]

In case I forgot any, please tell me

[ToothyDev]

DA344 said I could also flesh out the method signatures of both methods to actually list and typehint the possible (kw)args for both functions, so, if you want that, just say so.

[Dorukyum]

I think it'd be better if the arguments were explicitly type hinted.

[Lulalaby]

I agree with doru

[ToothyDev]

This removes the @property decorator from ApplicationContext.respond and makes the function async instead, because otherwise I can't properly overload it. In my testing, this was in no way breaking, and I already brought up in Discord how that decorator seems unnecessary for that method, but let me know what you think

[ToothyDev]

I'd prefer this to be in 2.7.1 instead of 2.8 as in it's current form, it only really consists of adding missing documentation, even though that had to involve a minor code change (which doesn't cause any user code to break)

[Paillat-dev]

code lgtm; test; thanks typing is nice :)

fixed