migrate to openapiv3 1.0.0-beta.3

[ahl]

I've been trying to get openapiv3 ready for a "1.0". A corner case regarding array handling seemed like a decent reason to try out the new version. This includes some other tidying up.

[davepacheco]

I don't totally understand all the checks but this seems fine. If we want to remove the deprecated function we should definitely update the changelog and make sure we bump the Dropshot version so that this is semver-incompatible.

[ahl]

If we want to remove the deprecated function we should definitely update the changelog and make sure we bump the Dropshot version so that this is semver-incompatible.

I don't have a preference. We can leave it or I can bump the version -- do you have a preference?

[davepacheco]

Yeah, I definitely want to honor semver with Dropshot's version number. I'd like to have entries in the changelog for breaking changes that explain how to know if you're affected and what to do about it. This one would be pretty simple: if you're using this function, use that other function instead.

[ahl]

@davepacheco does this suffice?

[davepacheco]

Yes, that note's perfect. Thanks!