MDL-78282 - [docs] Document sr_text output method

[ferranrecio]

Document the new output methods created in MDL-78282

[netlify]

✅ Deploy Preview for moodledevdocs ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	a162f57
🔍 Latest deploy log	https://app.netlify.com/sites/moodledevdocs/deploys/64d626c8669eeb000822b91a
😎 Deploy Preview	https://deploy-preview-693--moodledevdocs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[github-actions]

⚡️ Lighthouse report for the deploy preview of this PR

URL	Performance	Accessibility	Best Practices	SEO	PWA	Report
/	🟠 64	🟠 87	🟢 92	🟢 90	🟢 100	Report
/docs/apis/commonfiles	🔴 38	🟠 85	🟢 92	🟢 100	🟢 100	Report
/general/development/gettingstarted	🟠 53	🟠 87	🟢 92	🟢 90	🟢 100	Report
/general/releases	🔴 49	🟠 87	🟢 92	🟢 100	🟢 100	Report

[junpataleta]

Thanks, Ferran. This looks good in general. A few points:

• It might be worth adding an example output of the function.
• Also, perhaps add a description about when it can be used or when it should not be used. E.g. the contents cannot be block elements as it will break HTML validation.

[ferranrecio]

Hi @junpataleta ,

I amended the commit, adding an output example. However, I don't know in which cases it should not be used. Do we have any guide we can link to?

[sarjona]

Thanks for working on this, Ferran. The patch looks good and I think it's good enough to have it as it is because it can be improved in the future, if required, to add more information :-)