Merge branch 'docs/fix-pod-links'

Changes

@@ -13,6 +13,7 @@
     [ DOCUMENTATION ]
     * GH #1657: Fix the Dancer2::DeprecationPolicy abstract (Jason A. Crome)
     * GH #1661: Add 'gen' command to 'dancer2' runs (Steve Bertrand)
+    * PR #1671: Fix broken links in POD; avoid passive voice (Tom Hukins)
 
 0.400000  2022-03-13 22:16:13-04:00 America/New_York
 

lib/Dancer2/Manual.pod

@@ -187,8 +187,8 @@ requests.
 =head2 Route Handlers
 
 The route action is the code reference declared. It can access parameters
-through the specific L<route_parameters|/route_parameters>, 
-L<query_parameters|/query_parameters>, and  L<body_parameters|/body_parameters>
+through the specific L<route_parameters|Dancer2::Manual::Keywords/route_parameters>,
+L<query_parameters|Dancer2::Manual::Keywords/query_parameters>, and L<body_parameters|Dancer2::Manual::Keywords/body_parameters>
 keywords, which return a L<Hash::MultiValue> object. 
 This hashref is a merge of the route pattern matches and the request params.
 
@@ -521,7 +521,7 @@ This is done with the B<pass> keyword, like in the following example
 
 Hooks are code references (or anonymous subroutines) that are triggered at
 specific moments during the resolution of a request.  They are set up using the
-L<hook|/hook> keyword.
+L<hook|Dancer2::Manual::Keywords/hook> keyword.
 
 Many of them are provided by Dancer2's core, but plugins and engines can also
 define their own.
@@ -534,7 +534,7 @@ C<before> hooks are evaluated before each request within the context of the
 request and receives as argument the app (a L<Dancer2::Core::App> object).
 
 It's possible to define variables which will be accessible in the action
-blocks with the L<var keyword|/var>.
+blocks with the L<var keyword|Dancer2::Manual::Keywords/var>.
 
     hook before => sub {
         var note => 'Hi there';

lib/Dancer2/Manual/Keywords.pod

@@ -158,15 +158,15 @@ it is easier to change the C<content_type> setting instead.
 
 =head2 context
 
-Deprecated. Use L<app> instead.
+Deprecated. Use L</app> instead.
 
 =head2 dance
 
-Alias for the C<start> keyword. L<to_app> is preferable. 
+Alias for the C<start> keyword. L</to_app> is preferable.
 
 =head2 dancer_app
 
-Returns the app object. See L<app>.
+Returns the app object. See L</app>.
 
 =head2 dancer_version
 
@@ -252,7 +252,7 @@ Constant that returns a false value (0).
 
 =head2 flush
 
-Flush headers when streaming a response. Necessary when L<content> is called
+Flush headers when streaming a response. Necessary when L</content> is called
 multiple times.
 
 =head2 forward
@@ -375,11 +375,11 @@ Hence, it's not necessary anymore to use C<return> with halt.
 
 =head2 header
 
-Deprecated. Use L<response_header> instead.
+Deprecated. Use L</response_header> instead.
 
 =head2 headers
 
-Deprecated. Use L<response_headers> instead.
+Deprecated. Use L</response_headers> instead.
 
 =head2 hook
 
@@ -393,7 +393,7 @@ Adds a hook at some position. For example :
 There can be multiple hooks assigned to a given position, and each will be
 executed in order.
 
-See the L<HOOKS|/HOOKS> section for a list of available hooks.
+See L<Dancer2::Manual/HOOKS> for a list of available hooks.
 
 =head2 info
 
@@ -601,8 +601,8 @@ argument. If you close over it, you B<will> have a memory leak.
 
 =head2 psgi_app
 
-Provides the same functionality as L<to_app> but uses the deprecated
-Dispatcher engine. You should use L<to_app> instead.
+Provides the same functionality as L</to_app> but uses the deprecated
+Dispatcher engine. You should use L</to_app> instead.
 
 =head2 push_header
 
@@ -957,7 +957,7 @@ choices).
 This keyword should be called at the very end of the script, once all routes
 are defined. At this point, Dancer2 takes over.
 
-L<to_app> is preferable to L<dancer> or C<start>.
+Prefer L</to_app> instead of C<start>.
 
 =head2 status