Improve documentation of the `createRawSnippet` function

Describe the problem

The current description (1, 2) of this feature is rather sparse.

A previous version of the documentation (doc, comment from Pr) revealed more details.

Applying snippets programmatically is currently much less convenient than creating them declaratively. Hopefully, more detailed documentation will smooth out these differences.

Describe the proposed solution

I would like to see more examples of how to use it properly and in what cases.

Importance

nice to have