diff --git a/docs/layouts/_shortcodes/starcharts.html b/docs/layouts/_shortcodes/starcharts.html
index 93fceef3fe85..7695e2ee4eb7 100644
--- a/docs/layouts/_shortcodes/starcharts.html
+++ b/docs/layouts/_shortcodes/starcharts.html
@@ -1,6 +1,15 @@
+{{- /*
+Displays a starchart for a GitHub repository.
+Supports both light and dark mode.
+
+@param {string} repo The name of the GitHub repository.
+
+@example {{< starcharts repo="golangci/golangci-lint" >}}
+
+*/ -}}
 {{- $repo := .Get "repo" -}}
 
-<a href="https://starchart.cc/{{ $repo }}">
+<a href="https://starchart.cc/{{ $repo }}" target="_blank">
   <img
     alt="Stargazers over time"
     src="https://starchart.cc/{{ $repo }}.svg"