Interactivity API Docs: Add async actions documentation.

[cbravobernal]

What?

Developers will first try to use async/await on their actions. And the best way not to get wrong getContext() values is by using generators instead.

[github-actions]

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: c4rl0sbr4v0 <[email protected]>
Co-authored-by: fabiankaegy <[email protected]>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

[fabiankaegy]

The only thing I worry about here is that we have the full code example of what not to do.

In reality we often use documentation not to read all of it but to do a find and replace of something we are looking for.

I'm a little worried that having the incorrect code example in this would actually lead to more people missing the context outside of the code example and assume it is right.

Because of that I would almost say let's remove that code example and only describe it.

But that is just my thought on the matter :) definitely not blocking feedback

[cbravobernal]

The only thing I worry about here is that we have the full code example of what not to do.

In reality we often use documentation not to read all of it but to do a find and replace of something we are looking for.

I'm a little worried that having the incorrect code example in this would actually lead to more people missing the context outside of the code example and assume it is right.

Because of that I would almost say let's remove that code example and only describe it.

But that is just my thought on the matter :) definitely not blocking feedback

Sure, let's avoid copy-pasta issues, I've been on the same boat of copying first, read later 😅