I think this repo is awesome for providing code samples! However I think it should also aspire to show how to do things The Right Way (tm). Especially given that we print out a huge warning that says to users: "eat your vegetables".
My experience working on docs#631 so far is teaching me that (at least for Java) doing it the "right way" is quite complex! (But in the bad, uninteresting, fiddly and hard-to-get-right way, not in any of the good ways.)
I might be able to help with some PRs once I get through the docs issue and understand this a little better, but filing this to capture.
I think this repo is awesome for providing code samples! However I think it should also aspire to show how to do things The Right Way (tm). Especially given that we print out a huge warning that says to users: "eat your vegetables".
My experience working on docs#631 so far is teaching me that (at least for Java) doing it the "right way" is quite complex! (But in the bad, uninteresting, fiddly and hard-to-get-right way, not in any of the good ways.)
I might be able to help with some PRs once I get through the docs issue and understand this a little better, but filing this to capture.