diff --git a/templates/repo/icon.tmpl b/templates/repo/icon.tmpl
index cb469c4611..d1c3928244 100644
--- a/templates/repo/icon.tmpl
+++ b/templates/repo/icon.tmpl
@@ -1,8 +1,8 @@
 {{/* Template Attributes:
-* Repo: The repo
-* ShowRepoAvatar: Enable repo avatar when `true`
-* ShowRepoOwnerAvatar: Enable owner avatars when `true`
-* Size: Icon size in pixels
+* Repo (string, required): The repo
+* Size (int, required): Icon size in pixels
+* ShowRepoAvatar (boolean, optional): Render the repo's avatar, if one is set
+* ShowRepoOwnerAvatar (boolean, optional): Render the repo's owner avatar
 *
 * Note: Keep the icon logic in sync with web_src/js/utils/mappings.ts
 */}}