Docs: Add note that you might want Title::getLinkURL

While there are valid use cases of Title::getLocalURL, it is safer
to use Title::getLinkURL in most instances.  Additionally developers
won't accidentally their fragments that way.

Change-Id: I1bf567ba9c38103d39a883e8ea3a60f9f2082181

diff --git a/includes/Title.php b/includes/Title.php
index ab55257..2481178 100644 (file)
--- a/includes/Title.php
+++ b/includes/Title.php
@@ -1643,6 +1643,8 @@ class Title {
         * $wgServer is prepended to make an absolute URL.
         *
         * @see self::getFullURL to always get an absolute URL.
+        * @see self::getLinkURL to always get a URL that's the simplest URL that will be
+        *  valid to link, locally, to the current Title.
         * @see self::newFromText to produce a Title object.
         *
         * @param string|array $query An optional query string,