diff --git a/www/docs/deprecations.md b/www/docs/deprecations.md
index b61fea8d3..b24adcf7e 100644
--- a/www/docs/deprecations.md
+++ b/www/docs/deprecations.md
@@ -178,6 +178,9 @@ You can still get the same features by abusing the `name_template` property.
 
 Those two configurations will yield the same results.
 
+Notice that if you are using the `archives.name_template`, notice it also has a
+`{{.Version}}` in it. Adjust the new `name_template` accordingly.
+
 
 ### nfpms.replacements