Raku / doc

🦋 Raku documentation
https://docs.raku.org/
Artistic License 2.0
290 stars 293 forks source link

Need a better example of formatting code L<> (Links), particularly for links to another pod document #4481

Closed tbrowder closed 6 months ago

tbrowder commented 6 months ago

The current example under heading Links refers to "first example" and "second example," but the displays of the examples are not clearly delineated (at least to my eyes).

I would like to see a clear separation of the two examples, and a better explanation of which line of the paired lines does what. Here is an example of what would help me:

In example number 1, the first line in the displayed code block is an entry in the current pod document (file: some.pod). The second line in the displayed code block is the link to another pod document (file: another.pod).