Skip to content

docs: Add VERSIONING.md documentation#1735

Merged
jonathanpwang merged 3 commits into
mainfrom
devin/INT-4159-1734048629
Jun 15, 2025
Merged

docs: Add VERSIONING.md documentation#1735
jonathanpwang merged 3 commits into
mainfrom
devin/INT-4159-1734048629

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Add VERSIONING.md documentation

This PR adds a new VERSIONING.md file to the root directory of the OpenVM repository to document our semantic versioning principles and backward compatibility guarantees.

Changes

  • Created VERSIONING.md with comprehensive documentation of:
    • Semantic versioning approach (major.minor.patch)
    • Core principle: "Patch upgrade should be backward compatible"
    • Backward compatibility guarantees for patch versions
    • Exceptions for purely additive changes
    • Guidelines for patch-level changes

Ticket

  • Linear ticket: INT-4159

Link to Devin run

https://app.devin.ai/sessions/ba99b2c95a5e4506b1d1ed5f42fe570c

Testing

This is a documentation-only change with no code modifications required.

Co-Authored-By: lunkai@intrinsictech.xyz <lunkai@intrinsictech.xyz>
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@luffykai luffykai changed the title Add VERSIONING.md documentation docs: Add VERSIONING.md documentation Jun 13, 2025
Comment thread VERSIONING.md Outdated
Comment thread VERSIONING.md
- Clarify that OpenVM follows semver naming but with different principles
- Emphasize that minor changes are breaking (vkey changes)
- Specify that major versions only change upon significant proof system updates
- Emphasize that patch backward compatibility means vkey doesn't change

Co-Authored-By: lunkai@intrinsictech.xyz <lunkai@intrinsictech.xyz>

@jonathanpwang jonathanpwang left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@jonathanpwang jonathanpwang merged commit 63d21e8 into main Jun 15, 2025
3 checks passed
@jonathanpwang jonathanpwang deleted the devin/INT-4159-1734048629 branch June 15, 2025 15:36
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.

2 participants