diff --git a/scripts/install/install_rhel-derivs.sh b/scripts/install/install_rhel-derivs.sh
index 64bd77d057..abb67d60b3 100755
--- a/scripts/install/install_rhel-derivs.sh
+++ b/scripts/install/install_rhel-derivs.sh
@@ -142,4 +142,4 @@ echo
 echo
 echo "Install probably worked mostly correctly. Continue with the 'Configuration Guide':";
 echo
-echo "    http://www.phabricator.com/docs/phabricator/article/Configuration_Guide.html";
+echo "    https://secure.phabricator.com/book/phabricator/article/configuration_guide/";
diff --git a/scripts/install/install_ubuntu.sh b/scripts/install/install_ubuntu.sh
index 5e97397774..b3e678450d 100755
--- a/scripts/install/install_ubuntu.sh
+++ b/scripts/install/install_ubuntu.sh
@@ -87,6 +87,6 @@ echo
 echo
 echo "Install probably worked mostly correctly. Continue with the 'Configuration Guide':";
 echo
-echo "    http://www.phabricator.com/docs/phabricator/article/Configuration_Guide.html";
+echo "    https://secure.phabricator.com/book/phabricator/article/configuration_guide/";
 echo
 echo "You can delete any php5-* stuff that's left over in this directory if you want.";
diff --git a/src/docs/contributor/bug_reports.diviner b/src/docs/contributor/bug_reports.diviner
index bdb096dcb8..74bf0a2fcb 100644
--- a/src/docs/contributor/bug_reports.diviner
+++ b/src/docs/contributor/bug_reports.diviner
@@ -56,12 +56,8 @@ be able to resolve it more easily if you file a report based on HEAD. (For
 example, an old stack trace may not have the right line numbers, which will
 make it more difficult for us to figure out what's going wrong.)
 
-To update Phabricator, use a script like this one:
-
-http://www.phabricator.com/rsrc/install/update_phabricator.sh
-
-This script will require some adjustments depending on how your setup is
-configured, which webserver you are using, etc.
+To update Phabricator, use a script like the one described in
+@{article:Upgrading Phabricator}.
 
 **If you can not update** for some reason, please include the version of
 Phabricator you are running in your report. The version is just the Git hash
diff --git a/src/docs/user/upgrading.diviner b/src/docs/user/upgrading.diviner
index e8b7228ade..4291ded636 100644
--- a/src/docs/user/upgrading.diviner
+++ b/src/docs/user/upgrading.diviner
@@ -53,6 +53,9 @@ Upgrade Process
 
 IMPORTANT: You **MUST** restart Apache or PHP-FPM after upgrading.
 
+IMPORTANT: You **MUST** upgrade `libphutil`, `arcanist` and `phabricator` at
+the same time.
+
 Phabricator runs on many different systems, with many different webservers.
 Given this diversity, we don't currently maintain a comprehensive upgrade
 script which can work on any system. However, the general steps are the same
diff --git a/src/docs/user/userguide/arcanist.diviner b/src/docs/user/userguide/arcanist.diviner
index 826ee7d7a6..41613db968 100644
--- a/src/docs/user/userguide/arcanist.diviner
+++ b/src/docs/user/userguide/arcanist.diviner
@@ -12,7 +12,7 @@ A detailed command reference is available by running `arc help`. This
 document provides an overview of common workflows and installation.
 
 Arcanist has technical, contributor-focused documentation here:
-<http://www.phabricator.com/docs/arcanist/>
+<https://secure.phabricator.com/book/arcanist/>
 
 = Quick Start =