diff --git a/content/en/docs/contribute/style/hugo-shortcodes/index.md b/content/en/docs/contribute/style/hugo-shortcodes/index.md
index 85310d9f37ce8..f7cefb7d9d2c3 100644
--- a/content/en/docs/contribute/style/hugo-shortcodes/index.md
+++ b/content/en/docs/contribute/style/hugo-shortcodes/index.md
@@ -271,9 +271,7 @@ Renders to:
 {{< tab name="JSON File" include="podtemplate.json" />}}
 {{< /tabs >}}
 
-### Source code files
-
-`{{%/* codenew */%}}` shortcode is replaced by `{{%/* code */%}}`.
+## Source code files
 
 You can use the `{{%/* code */%}}` shortcode to embed the contents of file in a code block to allow users to download or copy its content to their clipboard. This shortcode is used when the contents of the sample file is generic and reusable, and you want the users to try it out themselves.
 
@@ -300,6 +298,9 @@ where `<RELATIVE-PATH>` is the path to the sample file to include, relative to t
 {{%/* code file="configmap/configmaps.yaml" */%}}
 ```
 
+The legacy `{{%/* codenew */%}}` shortcode is being replaced by `{{%/* code */%}}`.
+Use `{{%/* code */%}}` in new documentation.
+
 ## Third party content marker
 
 Running Kubernetes requires third-party software. For example: you