diff --git a/image-index.md b/image-index.md
index 02ce5dbd1..268563400 100644
--- a/image-index.md
+++ b/image-index.md
@@ -55,7 +55,9 @@ For the media type(s) that this document is compatible with, see the [matrix][ma
 
     - **`os.version`** *string*
 
-        This OPTIONAL property specifies the operating system version, for example `10.0.10586`.
+        This OPTIONAL property specifies the version of the operating system targeted by the referenced blob.
+        Implementations MAY refuse to use manifests where `os.version` is not known to work with the host OS version.
+        Valid values are implementation-defined. e.g. `10.0.14393.1066` on `windows`.
 
     - **`os.features`** *array of strings*
 
diff --git a/specs-go/v1/descriptor.go b/specs-go/v1/descriptor.go
index c461647ef..3394df59f 100644
--- a/specs-go/v1/descriptor.go
+++ b/specs-go/v1/descriptor.go
@@ -51,7 +51,7 @@ type Platform struct {
 	OS string `json:"os"`
 
 	// OSVersion is an optional field specifying the operating system
-	// version, for example `10.0.10586`.
+	// version, for example on Windows `10.0.14393.1066`.
 	OSVersion string `json:"os.version,omitempty"`
 
 	// OSFeatures is an optional field specifying an array of strings,