diff --git a/basis/values/values-docs.factor b/basis/values/values-docs.factor
index 866af469e9..59bf77da3a 100644
--- a/basis/values/values-docs.factor
+++ b/basis/values/values-docs.factor
@@ -15,7 +15,16 @@ ABOUT: "values"
 HELP: VALUE:
 { $syntax "VALUE: word" }
 { $values { "word" "a word to be created" } }
-{ $description "Creates a value on the given word, initializing it to hold " { $code f } ". To get the value, just run the word. To set it, use " { $link set-value } "." } ;
+{ $description "Creates a value on the given word, initializing it to hold " { $snippet "f" } ". To get the value, just run the word. To set it, use " { $link POSTPONE: to: } "." }
+{ $examples
+  { $example
+    "USING: values math prettyprint ;"
+    "VALUE: x"
+    "2 2 + to: x"
+    "x ."
+    "4"
+  }
+} ;
 
 HELP: get-value
 { $values { "word" "a value word" } { "value" "the contents" } }