Include real code samples in documentation

[robfletcher]

Too much chance of error. I don't think mkdocs supports it though so may have to pre-process or use something else.

[robfletcher]

Possible to use/adapt this? https://github.com/Kotlin/kotlinx.coroutines/tree/master/knit

[cjbrooks12]

Orchid now natively supports Kotlin code docs, and using Orchid would open up a world of possibilities like real code samples and versioned Github Pages deploys, if you'd want to switch away from JBake. You can see an example site with Kotlin docs here. I'd be willing to get this set up, converting the current theme and content to Orchid.

[robfletcher]

Sounds great. I would be 100% open to moving to Orchid. I did try it out a few months back but got stuck trying to get the API docs published along with the site (can't remember the specific issue now).

[robfletcher]

Fixed by migration to Orchid