From b3f699a77d3e8d2750ba69f877e344cc222c20fd Mon Sep 17 00:00:00 2001
From: William Lindley <wlindley@wlindley.com>
Date: Thu, 18 Feb 2021 19:14:49 -0500
Subject: [PATCH] Explain why the example in Guides/Tutorial#Blocks gives
 arguments to link_to in an unusual order.

---
 lib/Mojolicious/Plugin/TagHelpers.pm | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/Mojolicious/Plugin/TagHelpers.pm b/lib/Mojolicious/Plugin/TagHelpers.pm
index a3adac7b2f..c1904eef66 100644
--- a/lib/Mojolicious/Plugin/TagHelpers.pm
+++ b/lib/Mojolicious/Plugin/TagHelpers.pm
@@ -488,6 +488,12 @@ content.
   <a href="https://mojolicious.org">Mojolicious</a>
   <a href="http://127.0.0.1:3000/current/path?foo=bar">Retry</a>
 
+The first argument to C<link_to> is the link content, except when the
+final argument is Perl code such as a template block (created with the
+C<begin> and C<end> keywords); in that case, the link content is
+omitted at the start of the argument list, and the block will become
+the link content.
+
 =head2 month_field
 
   %= month_field 'vacation'