diff --git a/scripts/install/install_rhel-derivs.sh b/scripts/install/install_rhel-derivs.sh
--- a/scripts/install/install_rhel-derivs.sh
+++ b/scripts/install/install_rhel-derivs.sh
@@ -142,4 +142,4 @@
 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
--- a/scripts/install/install_ubuntu.sh
+++ b/scripts/install/install_ubuntu.sh
@@ -87,6 +87,6 @@
 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
--- a/src/docs/contributor/bug_reports.diviner
+++ b/src/docs/contributor/bug_reports.diviner
@@ -56,12 +56,8 @@
 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 this 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
--- a/src/docs/user/upgrading.diviner
+++ b/src/docs/user/upgrading.diviner
@@ -53,6 +53,9 @@
 
 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
--- a/src/docs/user/userguide/arcanist.diviner
+++ b/src/docs/user/userguide/arcanist.diviner
@@ -12,7 +12,7 @@
 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 =