API porting documentation unclear - changes in 1.5.0 and older versions

[xuijuthub]

Looking at documentation porting guides API levels are not menioned.. Seems to require guesswork or digging old versions for changes on compile errors to determine which API level implemented what.
mixxxdj/mixxx#15293 (comment)

I believe there should be more attention documenting API changes, or random bugs caused by changes might overwhelm and disencourage users to update.

[ktmf01]

Have you seen this: https://xiph.org/flac/api/group__porting.html

Seems pretty comprehensive to me?

[xuijuthub]

Yes, it does not specify the fact API level was incremented (causes people think by intuition that 1.4 is 14, 1.5 is 15), or that more error types were added FLAC__STREAM_DECODER_ERROR_STATUS_OUT_OF_BOUNDS FLAC__STREAM_DECODER_ERROR_STATUS_MISSING_FRAME although that might not be a problem if it's just a warning, but still would be nice to see those additions as changes in API documentation.

Just a heads up. Thank you.