Missing docs for Astro.callAction in guides/actions

[Rados51]

📚 Subject area/topic

Actions

📋 Suggested page

https://docs.astro.build/en/guides/actions/

📋 General description or bullet points (if proposing new content)

There are completely missing docs (on this page) for correct calls from server-side Astro component.
If we call it from Astro component with actions.getGreeting instead of Astro.callAction(...), the context is non-existing.
I was just scratching my head for a few minutes until I found out the correct way.

// ❌ Wrong
await actions.getGreeting({ name: "Bob" });
// ✅ Correct
await Astro.callAction(actions.getGreeting, { name: "Bob" });

🖥️ Reproduction of code samples in StackBlitz

No response

[sarah11918]

Thanks for pointing this out! I know the release notes from where this utility function was introduced are here: https://github.com/withastro/astro/releases/tag/astro%404.13.1

I can see that the API reference docs were added at that time, but an example of calling a function server-side wasn't included in the final stable documentation. I'll ask @bholmesdev to let us know whether there is a reason for not showing this on the main page (discouraging this use?). If so, maybe we can make sure there's at least a convenient link to the two functions since they're not in the Actions section itself, and might be hard to find!