diff --git a/docs/deprecations.md b/docs/deprecations.md
index 3f1b99043..b758cd2e8 100644
--- a/docs/deprecations.md
+++ b/docs/deprecations.md
@@ -98,13 +98,15 @@ templates can be shared among multiple pages:
 
     ``` markdown
     ---
-    template: overrides/hero.html
+    template: hero.html
     ---
     ```
 
 === "Template"
 
     ``` html
+    {% extends "base.html" %}
+
     {% block hero %}
       <!-- Add custom hero here -->
     {% endblock %}