Referring to internal documents with [~xx~]

This page has the following bulleted piece of information:
http://modxcms.com/editor-wysiwyg.html

MODx also has a special tag to use for referring to internal documents. It takes the form [~xx~], where xx is the ID of the document you wish to link to. This can also be combined with other MODx tags. For example, to create a link to your home page: <a href="Home.html>Home</a>

Huh??? I don’t understand why you mention that there is a "special tag", but then you give an example of a plain old regular HTML tag. Am I missing something?

Next to the title of every document in the tree is a number in parenthesis. So your home page might look like:

home (1)

Given that you can link to it in other MODx pages by using the following:

You might want to update the documentation to include an example of that instead of the regular HTML link.