Description of problem:
in our document:
https://docs.openshift.com/enterprise/3.1/architecture/core_concepts/builds_and_image_streams.html#tag-tracking
you could set tag as following using oc tag command:
"spec": {
    "tags": [
      {
        "name": "latest",
        "from": {
          "kind": "ImageStreamTag",
          "name": "2.0"
        }
      }
    ]
  }
in this way you could make sure you will deploy latest by deploy 2.0.
However in 3.1 when you use oc tag, you will get following in image stream:
"spec": {
        "tags": [
            {
                "name": "2.0",
                "from": {
                    "kind": "ImageStreamImage",
                    "name": "cakephp-example@sha256:218dcb6c709960e62e1e1ee46721bed35dfe141695f3f0df60b755a0e66ed420"
                }
            },
            {
                "name": "latest",
                "from": {
                    "kind": "ImageStreamImage",
                    "name": "cakephp-example@sha256:218dcb6c709960e62e1e1ee46721bed35dfe141695f3f0df60b755a0e66ed420"
                }
            }
        ]
    },

You could also deploy 2.0 by deploy latest but the difference between this and the document is you lose the track between 2.0 and latest. It means when you want to use this image in multiple project with multiple tags, you are not sure which image is deployed unless you check sha value. 

Version-Release number of selected component (if applicable):


How reproducible:
# oc tag cakephp-example:latest cakephp-example:2.0

Steps to Reproduce:
1.oc tag cakephp-example:latest cakephp-example:2.0
2.
3.

Actual results:
"spec": {
        "tags": [
            {
                "name": "2.0",
                "from": {
                    "kind": "ImageStreamImage",
                    "name": "cakephp-example@sha256:218dcb6c709960e62e1e1ee46721bed35dfe141695f3f0df60b755a0e66ed420"
                }
            },
            {
                "name": "latest",
                "from": {
                    "kind": "ImageStreamImage",
                    "name": "cakephp-example@sha256:218dcb6c709960e62e1e1ee46721bed35dfe141695f3f0df60b755a0e66ed420"
                }
            }
        ]
    },

Expected results:
"spec": {
        "tags": [
            {
                "name": "0.0.2",
                "from": {
                    "kind": "ImageStreamImage",
                    "name": "aem-processing@sha256:the_built_0.0.2_image"
                }
            },
            {
                "name": "0.0.1",
                "from": {
                    "kind": "ImageStreamImage",
                    "name": "aem-processing@sha256:the_built_0.0.1_image"
                }
            },
            {
                "name": "release",
                "from": {
                    "kind": "ImageStreamTag",
                    "name": "0.0.1"
                }
            },
            {
                "name": "prerelease",
                "from": {
                    "kind": "ImageStreamTag",
                    "name": "0.0.2"
                }
            },
            {
                "name": "latest",
                "from": {
                    "kind": "DockerImage",
                    "name": "aem-processing:latest"
                }
            }
        ]
    }

Additional info: