["Request"] Do a pass on documentation, and examples in KDoc

[nomisRev]

What version are you currently using?

1.2.0-RC

What would you like to see?

The KDoc is minimal and lacks examples. For example, on raise() we have just "Raise a logical failure of type Error". Btw GPT-4 generate killer docs if you give him some context and good prompts - ofc it needs human verification but it can greatly speed-up the docs process.

https://kotlinlang.slack.com/archives/C5UPMM0A0/p1680904729946789

[ILIYANGERMANOV]

Raised a small PR that improves the KDoc around Raise:
#3038