Use Swift Snippets for compilable sample code embedded in docs

[czechboy0]

We should explore Swift Snippets for our documentation, to ensure they continue to compile successfully even as we evolve the API.

Today, we have to update the snippets in docs manually, and thus they can get out of sync.