Should the crate be used with a git hash or with the published version

[mat813]

Hi,

I've been using progenitor for about a semester, and when I started, I had to set progenitor = { git = "https://github.com/oxidecomputer/progenitor" } because the published crate (around the 0.8.0 times) was not working for me.
It seems things changed quite a bit since, and there are regular releases.
So I've been wondering if I should still be using progenitor directly from the git repository, or if I should switch to the published crates (as of today) progenitor = "=0.11.0".

[ahl]

If a published version is working for you, I'd say use that. We try very hard not to regress supported OpenAPI constructions (and will do our best to fix them if and when we do). We also mostly try to not introduce changes that would constitute breaking changes in the generated output, but we don't adhere strictly to that in particular because in some cases we generate (and continue to generate) pretty unusable output to which we don't want to be beholden.

On the other hand, if something is busted in the published crate and seems to be working on main, then please ask for a release or feel free to use a git dependency.

If there's some addition to the README that would be helpful, please feel free to submit a PR! We would love the contribution.