diff --git a/basis/deprecation/deprecation-docs.factor b/basis/deprecation/deprecation-docs.factor
new file mode 100644
index 0000000000..79ade7ab51
--- /dev/null
+++ b/basis/deprecation/deprecation-docs.factor
@@ -0,0 +1,13 @@
+! (c)2009 Joe Groff bsd license
+USING: help.markup help.syntax kernel words ;
+IN: deprecation
+
+HELP: :deprecations
+{ $description "Prints all deprecation notes." } ;
+
+ARTICLE: "deprecation" "Deprecation tracking"
+"Factor's core syntax defines a " { $link POSTPONE: deprecated } " word that can be applied to words to mark them as deprecated. When the " { $vocab-link "deprecation" } " vocabulary is loaded, notes will be collected and reported by the " { $link "tools.errors" } " mechanism when deprecated words are used to define other words."
+{ $subsection POSTPONE: deprecated }
+{ $subsection :deprecations } ;
+
+ABOUT: "deprecation"