Rewrite L<> section (#4482)

Fixes #4481

Author: coke

doc/Language/pod.rakudoc

@@ -550,41 +550,38 @@ C<my $var = 1; say $var;>
 
 =head2 Links
 
-To create a link enclose it in C<L< >>
-
-A vertical bar (optional) separates label and target.
-
-The target location can be an URL (first example) or a local Pod6 document
-(second example). Local file names are relative to the base of the project, not
-the current document.
+To create a link enclose it in C<L< >>:
 
 =for code :lang<rakudoc>
 Raku homepage L<https://raku.org>
-L<Raku homepage|https://raku.org>
 
 Raku homepage L<https://raku.org>
 
+An optional vertical bar can be used to separate the label from the target.
+
+=for code :lang<rakudoc>
 L<Raku homepage|https://raku.org>
 
+L<Raku homepage|https://raku.org>
+
+Relative URLs are relative to the base of the project, so in this repository,
+for example, we can link to another page in the C<language> folder. Here we
+use an optional fragment to link to a heading:
+
 =for code :lang<rakudoc>
-Structure L</language/about#Structure|/language/about#Structure>
 L<Structure|/language/about#Structure>
 
-Structure L</language/about#Structure|/language/about#Structure>
-
 L<Structure|/language/about#Structure>
 
-To create a link to a section in the same document:
+One can also specify a link to a fragment in the current document:
+
 =for code :lang<rakudoc>
-Comments L<#Comments>
 L<Comments|#Comments>
 
-Comments L<#Comments>
-
 L<Comments|#Comments>
 
-Alongside the normal way of describing a path, viz. C«L<Some reference|path/to/filename>», it is also
-possible to use the module-style notation, e.g., C«L<Some reference|path::to::filename>».
+Finally, in addition to URL-style links (e.g. C«L<Some reference|path/to/filename>»),
+module-style notation (C«L<Some reference|path::to::filename>») also works.
 
 =head2 Placement links