Doc samples inconsistently demonstrate best practices

[ianbotsf]

Describe the issue

Broadly, the code samples repository shows a range of styles for usage of the Kotlin SDK, some of which are not best practices for typical situations. This leads to user confusion as demonstrated in #1261. Take a comprehensive look at the samples repo, catalog areas for improvement, and work to incorporate the updates into public docs.

Links

Various. More detailed list coming soon.

[github-actions]

This is a very old issue that is probably not getting as much attention as it deserves. We encourage you to check if this is still an issue in the latest release and if you find that this is still a problem, please feel free to provide a comment or open a new issue.