Bug 1235445 - [DOCS] Define client tools version policy
Summary: [DOCS] Define client tools version policy
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.0.0
Hardware: Unspecified
OS: Unspecified
low
low
Target Milestone: ---
: ---
Assignee: Ashley Hardin
QA Contact: Vikram Goyal
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks: 1267746
TreeView+ depends on / blocked
 
Reported: 2015-06-24 20:23 UTC by Aleksandar Kostadinov
Modified: 2016-09-27 23:25 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-09-27 23:25:14 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Aleksandar Kostadinov 2015-06-24 20:23:28 UTC
I see currently version of client tools is:

> $ oc version
> oc v3.0.0.0-32-g3ae1d27
> kubernetes v0.17.1-804-g496be63

Can we have a document with policy to not break backward comatibility between minor releases, maybe the second '0' in that version string? It would be very valuable in scripting to check that available cli tool version is compatible.

At the moment I don't know which part of the version string to rely on.

Comment 2 Vikram Goyal 2015-07-15 06:19:03 UTC
I am not sure if this is a docs bug? Alex - can you comment?

Comment 3 Alex Dellapenta 2015-07-16 03:46:09 UTC
There is probably room for some doc'ing of the expectations around backwards compatibility going forward for the API/CLI. Following up with SMEs.

Comment 9 Ashley Hardin 2016-07-13 14:57:41 UTC
Work in progress: https://github.com/openshift/openshift-docs/pull/2496

Comment 10 Ashley Hardin 2016-07-18 22:23:32 UTC
@Clayton, please review: https://github.com/openshift/openshift-docs/pull/2496

Thanks!

Comment 11 Ashley Hardin 2016-08-03 20:54:41 UTC
@Aleksandar, please review. Thanks!

Comment 12 Aleksandar Kostadinov 2016-08-04 07:53:16 UTC
Hello Ashley, I have put a comment in github some half a month ago but it was not answered. Also originally I proposed to commit Semantic Versioning compatibility (http://semver.org/).
I don't see that mentioned in the PR and I assumed we decided to not commit to it. Although I think it is good if we do.

Regards.

Comment 13 openshift-github-bot 2016-08-15 19:27:08 UTC
Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/46b535d8e252e1514857bf9362dd3c87364d0c26
Bug 1235445, added a Versioning Policy

https://github.com/openshift/openshift-docs/commit/9cafa6f1c18b389f0d295a925599fb44e2a63585
Merge pull request #2496 from ahardin-rh/versioning-policy

Bug 1235445, added a Versioning Policy


Note You need to log in before you can comment on or make changes to this bug.