On 27/07/16 19:43, Reed O'Brien wrote: > +1 > > On Wed, Jul 27, 2016 at 9:52 AM, Katherine Cox-Buday > <[email protected] > <mailto:[email protected]>> wrote: > > > I am a huge fan of publishing schema's and then generating SDKs > and documentation websites off of them. It brings your API closer > to language agnostic, removes the burden on us having to > hand-craft both our API client and our documentation site, and > makes validation implicit. I'm not up on what the best tools for > doing this are, but Swagger[1] seems to be popular. >
Schemas are excellent for test suites and tool validation, but auto-generated bindings are *always* uuuuugly. Please don't make that plan A for any language you care about. From a house perspective, Go, JS and Python need designed and human-curated bindings that are idiomatic for coders who love those languages. Mark
-- Juju-dev mailing list [email protected] Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
