cutlass icon indicating copy to clipboard operation
cutlass copied to clipboard

[QST] What is API version compatibility?

Open ZzEeKkAa opened this issue 1 year ago • 5 comments

I want to pin cutlass version that can work with my project, but could not find if cutlass follows semantic version. Right now project requires cutlass 3.5.1. Is it safe to have >=3.5.1;<4.0.0 restriction, or it should be >=3.5.1;<3.6.0?

ZzEeKkAa avatar Jan 06 '25 20:01 ZzEeKkAa

>=3.5.1;<4.0.0 should be good.

Our api will stay stable until we bump to 4.x. During 3.x time, we might only make some minor api changes.

hwu36 avatar Jan 08 '25 05:01 hwu36

What Haicheng said is far, but please also note that we don't strictly follow semver and have broken compatibility for minor internal methods here and there before. Pretty much anything not at the device layer abstraction doesn't promise 100% stability. That said, between minor version, we try our best to be nice and not break users too much even for abstractions below the device layer

thakkarV avatar Jan 08 '25 12:01 thakkarV

What Haicheng said is far, but please also note that we don't strictly follow semver and have broken compatibility for minor internal methods here and there before. Pretty much anything not at the device layer abstraction doesn't promise 100% stability. That said, between minor version, we try our best to be nice and not break users too much even for abstractions below the device layer

Should I interpret this comment as answer to #2009 and #2010 ?

edit. Seems like no, because you mean only internal methods

ankutalev avatar Jan 09 '25 06:01 ankutalev

I think fall in the same category as they are not device layer interfaces. 2009 is a fix more than breakage, since those operations only support saturating FMAs, so removing those is actually fixing the contract. 2010 is a regression if is breaks the user facing EVT API, but at a glance only the internals were changed?

thakkarV avatar Jan 09 '25 14:01 thakkarV

This issue has been labeled inactive-30d due to no recent activity in the past 30 days. Please close this issue if no further response or action is needed. Otherwise, please respond with a comment indicating any updates or changes to the original issue and/or confirm this issue still needs to be addressed. This issue will be labeled inactive-90d if there is no activity in the next 60 days.

github-actions[bot] avatar Feb 08 '25 15:02 github-actions[bot]

This issue has been labeled inactive-90d due to no recent activity in the past 90 days. Please close this issue if no further response or action is needed. Otherwise, please respond with a comment indicating any updates or changes to the original issue and/or confirm this issue still needs to be addressed.

github-actions[bot] avatar May 09 '25 15:05 github-actions[bot]