diff --git a/config.md b/config.md
index d6e8000e3..8d2d746d3 100644
--- a/config.md
+++ b/config.md
@@ -322,7 +322,7 @@ The semantics are the same as `Path`, `Args` and `Env` in [golang Cmd](https://g
 
 ## Annotations
 
-This OPTIONAL property contains arbitrary metadata for the container.
+**`annotations`** (object, optional) contains arbitrary metadata for the container.
 This information MAY be structured or unstructured.
 Annotations are key-value maps.
 
diff --git a/specs-go/config.go b/specs-go/config.go
index f4c6b28fc..3b5eeda41 100644
--- a/specs-go/config.go
+++ b/specs-go/config.go
@@ -18,7 +18,7 @@ type Spec struct {
 	Mounts []Mount `json:"mounts,omitempty"`
 	// Hooks configures callbacks for container lifecycle events.
 	Hooks Hooks `json:"hooks"`
-	// Annotations is an unstructured key value map that may be set by external tools to store and retrieve arbitrary metadata.
+	// Annotations contains arbitrary metadata for the container.
 	Annotations map[string]string `json:"annotations,omitempty"`
 
 	// Linux is platform specific configuration for Linux based containers.