|Re: [cross-project-issues-dev] Will the Platform Start Making Major Version Increments?|
On 10/30/18 11:29, Daniel Megert wrote:
Wouldn't it be best to update the wiki document, Version Numbering , with some explicit guideline in the hope for consistency between projects?
Or, do you think the pointer to Evolving Java-based APIs  suffices? It does have a section there that includes the following sentence:
Â [...] obsolete API elements are notoriously difficult to get rid of. Obsolete API elements should be marked
Â as deprecated and point new customers at the new API that replaces it, but need to continue working as advertised
Â for a couple more releases until the expense of breakage is low enough that it can be deleted.
But I think explicitness is best. I am not sure "... the expense of breakage is low enough ..." would be interpreted as "no major version change required".
I have opened BugÂ540859 in case further discussion is required it can be done there.