Implements support for generating samples from the examples trait.
Cleans up ShapeValueGenerator a bit to make the output formatting nicer (we previously only used it for generating protocol tests so minor formatting issues weren't a big deal but they should be cleaner for docs).
Notes
Code is output to src/samples directory. Samples are not automatically included by dokka, you have to update the configuration to get them included.
We decided to omit doing anything with the output of the examples trait and to omit error examples. It isn't clear what customer benefit there is to including them and instead decided to focus samples on making a request for the given operation.
This renders using the playground by default which won't actually work, see https://github.com/Kotlin/dokka/issues/3041. We will likely hold off merging this until that is disabled.
By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
Issue \
https://github.com/awslabs/aws-sdk-kotlin/issues/239
downstream: https://github.com/awslabs/aws-sdk-kotlin/pull/1143
Description of changes
ShapeValueGenerator
a bit to make the output formatting nicer (we previously only used it for generating protocol tests so minor formatting issues weren't a big deal but they should be cleaner for docs).Notes
src/samples
directory. Samples are not automatically included by dokka, you have to update the configuration to get them included.output
of the examples trait and to omit error examples. It isn't clear what customer benefit there is to including them and instead decided to focus samples on making a request for the given operation.By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.