in reply to propose updating node about linking to cpan modules
G'day Lotus1,
That's not a page I've used much (if at all); however; here's some thoughts on your proposal.
Instead of just changing what's already there, I think adding more link types might be a better way to go.
So: keep [cpan://...]; add [mod://...]; maybe add [dist://...]; and consider adding some or all of the other 10 link types shown in the CPAN section of the Shortcuts page.
I've always considered this to be a rather wordy node title. Furthermore, I don't really think it truly reflects the node's contents.
Although it says "shortcuts", this is actually the preferred markup for all links.
"Markup in the Monastery" says:
Links: Please, do NOT use <a href="http://example.com">something</a>. Instead, create links (especially those to nodes at PM) using [...]
The Link wisely section of "Writeup Formatting Tips" has little more than a link to the "What shortcuts can I use for linking to other information?" page.
And, "What shortcuts can I use for linking to other information?" itself, has (in the "All Links Within PerlMonks Should Be Relative" section):
Therefore, constructing a link like
<a href="http://www.perlmonks.com/index.pl?node_id=43037">shortcuts</a>
is not as good as [http://www.perlmonks.com/index.pl?node_id=43037|shortcuts]
which is not as good as <a href="/index.pl?node_id=43037">shortcuts</a>.
Best of all is to use [id://43037|shortcuts].
I agree the "other information" part suggests something other than what was originally intended: in your case, it suggests "other than CPAN"; elsewhere, it might suggest "external links".
Perhaps "How do I add a link to my post?" might be a better choice. This uses the same format as many of the links in "Posting on PerlMonks" (e.g. "How do I change/delete my post?"); in fact, it would probably be a useful addition to that page.
[In the interests of full disclosure, I will admit that, in order to get the "CPAN section of the Shortcuts page" link above, I needed to use: <a href="?node_id=43037#cpan">CPAN section of the Shortcuts page</a>. A [...] style link could not achieve this (or, at least, I couldn't find any way to do it, either by experimentation or documentation).]
-- Ken
|
|---|
| Replies are listed 'Best First'. | |
|---|---|
|
Re^2: propose updating node about linking to cpan modules
by choroba (Cardinal) on Apr 17, 2014 at 10:10 UTC | |
by kcott (Archbishop) on Apr 17, 2014 at 21:11 UTC | |
by tye (Sage) on Apr 17, 2014 at 14:35 UTC | |
by choroba (Cardinal) on Apr 17, 2014 at 15:11 UTC | |
by tye (Sage) on Apr 17, 2014 at 15:35 UTC | |
by jdporter (Paladin) on Apr 18, 2014 at 01:22 UTC | |
|