Change Web link help page doc

Question

Could we change the help section here: https://www.wikitree.com/wiki/Help:Adding_Links#Links_to_Other_Websites

It currently says: 

As you can see above, you simply enclose the URL in a single set of [brackets].

If you include a space after the URL and then text, e.g. "here's a link to a YouTube video", that becomes the "anchor text" in link.

Could we change it to something like: 

As you can see above, you simply enclose the URL in a single set of square brackets, with a space, and some anchor text [url "anchor text"]. In the example above, "here's a link to a YouTube video" becomes the "anchor text" in link.

Links in square brackets without anchor text should be avoided.

Comments

Lots of people do this unfortunately with no explanation included.

---

Perhaps "Anchor text" is a bit confusing? I tend to use the word "description". e.g. [URL description] It's not easy making it obvious to everyone!

---

I agree that it should be description or descriptive text. More understandable for non tech person.

---

I've been using anchor text, because it's the phrase already used in the Help Docs (and I don't want to start multiplying definitions). But yeah, I MUCH prefer "link text", and "description" makes sense, too.

Answer 1

Thanks Brad,

Excellent suggestion.

I find the absence of any anchor text in links very annoying.

Christine