diff --git a/hugolib/shortcode.go b/hugolib/shortcode.go
index 937a90956..bbd34e22b 100644
--- a/hugolib/shortcode.go
+++ b/hugolib/shortcode.go
@@ -41,7 +41,8 @@ type ShortcodeWithPage struct {
 	Parent        *ShortcodeWithPage
 	IsNamedParams bool
 
-	// Zero-based oridinal in relation to its parent.
+	// Zero-based ordinal in relation to its parent. If the parent is the page itself,
+	// this ordinal will represent the position of this shortcode in the page content.
 	Ordinal int
 
 	scratch *Scratch