Users are currently able to use "magic" (shorthand) Markdown links in comments, which are expanded into full urls with anchor text on submission. Unfortunately, the anchor text on many of these magic links are the same, and aren't very descriptive; many of them all say "help center", even though they point to different pages.
In the 2nd comment that says:
Please read help center, help center, and How to Ask.
The first "help center" link points to the on-topic page, while the second "help center" link points to the off-topic page, and yet their anchor text is the same, and this is confusing and awkward to read.
I tested this out with other magic links, as demonstrated in the 3rd comment in the screenshot, and the following magic links (which go to different help center pages) all have "help center" as their anchor text:
[help]
: Help Center[help/on-topic]
: What topics can I ask about here?[help/dont-ask]
: What types of questions should I avoid asking?[help/behavior]
: What kind of behavior is expected of users?[meta-help]
: What is "meta"? How does it work?
Please Make Magic Link Anchor Text Unique and Descriptive
I think the magic links I pointed out above would be more useful and less confusing if they each had their anchor text match the titles of the pages that they point to, or at least use more descriptive, unique text, like the following:
[help]
: "Help Center"[help/on-topic]
: "On-Topic"[help/dont-ask]
: "Off-Topic" or "Don't Ask"[help/behavior]
: "Expected Behavior" or "Rules of Conduct"[meta-help]
: "What is Meta?"
Examples
This is how it currently looks again:
Please read help center, help center, and How to Ask.
Here is an example of what my comment above would look like using the full titles of the pages as anchor text:
Please read What topics can I ask about here?, What types of questions should I avoid asking?, and How to Ask.
and this is what it would look like using the shorter anchor text:
Please read On-Topic, Don't Ask, and How to Ask.
How Will This Affect Existing Comments?
I was thinking about how this would affect existing comments that were written with the current anchor text in mind. Take, for example, a comment like this that pointed to What topics can I ask about here?:
Please read the help center.
This comment makes sense the way it is, but with the changes that I proposed, it would look like
Please read the What topics can I ask about here?.
or
Please read the On-Topic.
both of which are just as awkward as the current
Please read help center and help center.
We Can Live with This
I think this is OK though, and here's why: Help Center magic links are used in comments to help educate newbie users on how to use the site. Once a newbie user has read the linked pages (assuming they read them at all once they're pointed to them), then those older comments aren't needed anymore anyways. They don't help future users find the answers that they're looking for.
So if old comments using magic links become awkward like
Please read the On-Topic.
then that's OK, because they've already served their purpose.
[help/us/help/them/better]