diff --git a/docs/web-interface.md b/docs/web-interface.md
index e2a9dca..9fbb922 100644
--- a/docs/web-interface.md
+++ b/docs/web-interface.md
@@ -5,14 +5,13 @@ simply exposing SmartOS primitives via a web interface for the purposes of
 managing instances and aims to make simpler tasks much more approachable for new
 users, as well as make more complex tasks easier for advanced users.
 
-In all cases, the Web UI simply exposes what's already available in SmartOS
-in a more inviting way.
-
 Note that while we have tried to make sure SmartOS features are represented in
 the Web UI, not all features are yet exposed. And due to the nature of SmartOS
 being much more free form than Triton, it's possible that you may have a
-configuration on an instance or image that causes errors in the UI. Please
-report these errors so that we may correct this.
+configuration on an instance or image that causes errors in the UI.
+[Please report these][i] errors so that we may correct this.
+
+[i]: https://github.com/TritonDataCenter/smartos-ui/issues
 
 ## Installation
 
@@ -47,7 +46,8 @@ may be replaced with a custom certificate if you choose.
 
 ## The `uiadm` command
 
-The `uiadm` command can be used to upgrade or uninstall the Web UI.
+The `uiadm` command can be used to upgrade or uninstall the Web UI. It uses the
+following subcommands.
 
 <!-- markdownlint-disable line-length -->
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 2aaeb5a..6aeb45a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -47,6 +47,7 @@ nav:
             - "Installation Walkthrough": "install.md"
             - "Non-interactive Installation": "non-interactive-install.md"
         - "Getting Started with SmartOS": "getting-started-with-smartos.md"
+        - "Installing the SmartOS Web UI": "web-interface.md"
         - "Virtual Instances":
             - "How to create a native SmartOS Instance": "how-to-create-a-zone.md"
             - "How to create a Hardware Virtual Machine": "how-to-create-an-hvm-zone.md"