Merge pull request #39189 from stevsmit/BZ1900182-main

Removes versioning policy section

Author: stevsmit

_topic_maps/_topic_map.yml

@@ -53,8 +53,7 @@ Distros: openshift-enterprise
 Topics:
 - Name: OpenShift Container Platform 4.10 release notes
   File: ocp-4-10-release-notes
-- Name: Versioning policy
-  File: versioning-policy
+
 ---
 Name: Architecture
 Dir: architecture

cli_reference/openshift_cli/usage-oc-kubectl.adoc

@@ -21,6 +21,37 @@ The `oc` binary offers a built-in `login` command that allows authentication and
 +
 The additional command `oc new-app`, for example, makes it easier to get new applications started using existing source code or pre-built images. Similarly, the additional command `oc new-project` makes it easier to start a project that you can switch to as your default.
 
+[IMPORTANT]
+====
+If you installed an earlier version of the `oc` binary, you cannot use it to complete all of the commands in {product-title} {product-version}.  If you want the latest features, you must download and install the latest version of the `oc` binary corresponding to your {product-title} server version.
+====
+
+Non-security API changes will involve, at minimum, two minor releases (4.1 to 4.2 to 4.3, for example) to allow older `oc` binaries to update. Using new capabilities might require newer `oc` binaries. A 4.3 server might have additional capabilities that a 4.2 `oc` binary cannot use and a 4.3 `oc` binary might have additional capabilities that are unsupported by a 4.2 server.
+
+.Compatibility Matrix
+
+[cols="1,1,1"]
+|===
+
+|
+|*X.Y* (`oc` Client)
+|*X.Y+N* footnote:versionpolicyn[Where *N* is a number greater than or equal to 1.] (`oc` Client)
+
+|*X.Y* (Server)
+|image:redcircle-1.png[]
+|image:redcircle-3.png[]
+
+|*X.Y+N* footnote:versionpolicyn[] (Server)
+|image:redcircle-2.png[]
+|image:redcircle-1.png[]
+
+|===
+image:redcircle-1.png[] Fully compatible.
+
+image:redcircle-2.png[] `oc` client might not be able to access server features.
+
+image:redcircle-3.png[] `oc` client might provide options and features that might not be compatible with the accessed server.
+
 == The kubectl binary
 
 The `kubectl` binary is provided as a means to support existing workflows and scripts for new {product-title} users coming from a standard Kubernetes environment, or for those who prefer to use the `kubectl` CLI. Existing users of `kubectl` can continue to use the binary to interact with Kubernetes primitives, with no changes required to the {product-title} cluster.