Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

README: remove wrong claim about backwards compatibility #19465

Closed
wants to merge 1 commit into from

Conversation

Wertzui123
Copy link
Contributor

I have requested this change several times in the discord already. The response was always something like "those changes are handled automatically" or "V is not mature enough to not break things yet" - and while I agree with the latter, the statement that v fmt handles breaking changes is simply wrong (partially because it doesn't make any sense to automate that process in some situations).

One recent example of this is 11337e7; this commit forbids variables called thread to be declared and is not handled by v fmt.

Another case from half a year ago is 404a9aa.

Here's one more: 46f32fc; this only introduced a warning, but since warnings are errors in -prod mode, it also broke my code.

To make it clear, I very much think that those changes make sense and that V should break things from time to time, but I just don't like the claim.

Let's discuss this topic in this PR as I think we might want to introduce some kind of BC compatibility promise, but the current one is unrealistic and simply wrong.

@JalonSolov
Copy link
Contributor

The main problem with the stability section is that it should state "as of the 1.0 release". V doesn't guarantee anything until then, though it tries to remain as compatible as possible.

@cpajonk
Copy link

cpajonk commented Sep 28, 2023

👍 breaking changes are a normal part and more than understandable in early development.
It would increase trust if the claim is adapted to better reflect the actual situation.

@medvednikov
Copy link
Member

medvednikov commented Sep 30, 2023

Thanks.

I've made the wording much better. It now reflects the actual situation:

https://github.com/vlang/v#stability-future-changes-post-10-freeze

@Wertzui123
Copy link
Contributor Author

Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants