@@ -67,7 +67,14 @@ export const main = {
 
 export const pro = {
   'Home': '/docs',
-  'Introduction': '/docs/pro',
+  'Introduction': {
+    'Getting Started': '/docs/pro',
+    'Git Workflow': '/docs/pro/basics/git'
+  },
+  'Builds': {
+    'Build Types': '/docs/pro/builds/intro',
+    'Build Environments': '/docs/pro/builds/environments'
+  },
   'Deploy': {
     'Introduction': '/docs/pro/deploy/intro',
     'Installation': '/docs/pro/deploy/setup',
@@ -85,9 +92,6 @@ export const pro = {
     'Manage': '/docs/pro/automation/create',
     'Webhooks': '/docs/pro/automation/webhooks'
   },
-  'Environments': {
-    'Introduction': '/docs/pro/environments/intro'
-  }
 };
 
 export const outbound = {
 
@@ -90,11 +90,18 @@ export class DocsMenu {
 
   @Watch('path')
   setActiveItemFromPath(path) {
-    const topLevelKeys = Object.keys(menuMap.main);
+    // Decide if we should look at the Pro or Framework doc maps
+    let keyMap: any = menuMap.main;
+    if (path.includes('/pro')) {
+      keyMap = menuMap.pro;
+    }
+
+    // Find the URL we're at
+    const topLevelKeys = Object.keys(keyMap);
     const activeKey = topLevelKeys.find(key => {
-      const items = menuMap.main[key];
-      if (items === path) return true;
-      return Object.keys(items).some(itemKey => items[itemKey] === path);
+      const items = keyMap[key];
+      if (typeof(items) === 'string' && items.split('#')[0] === path) return true;
+      return Object.keys(items).some(itemKey => items[itemKey].split('#')[0] === path);
     });
     this.setActiveItem(activeKey);
   }
@@ -182,6 +189,19 @@ export class DocsMenu {
               return renderer(key, val, onClick);
             })}
           </ul>,
+          <ul>
+            <li style={{ marginTop: '1.5rem' }}>
+              <stencil-route-link
+                class="menu__item menu__item--outbound migration-pill"
+                url="/docs/building/migration"
+                exact>
+                  v4 Migration Guide
+                  <svg viewBox="0 0 16 24">
+                    <path d="M3 2l10 10L3 22" stroke-width="3" fill="none" fill-rule="evenodd"/>
+                  </svg>
+              </stencil-route-link>
+            </li>
+          </ul>
         ];
       case 'framework':
       default:
 
@@ -1,45 +1,25 @@
-# Managing Automations
+# Using Automations
 
-Creating new automations is simple.  To get started, simply navigate to the `Automate` tab within the desired app:
+## Managing Automations
 
-<img style="width: 230px" src="/docs/assets/img/pro/ss-automations-automate-tab.png" class="browser" />
+Creating and customizing automations is simple.  To get started, simply navigate to the `Automate` tab within the desired app.
 
-## Creating Automations
+To **create a new automation**, click the `New Automation` button on the top right of the `Automate` dashboard. When clicked, the automation customization form will appear, which has several fields available to customize the automation (Read more about these [below](#customizing-automations)). 
 
-To create a new automation, click the `New Automation` button on the top right of the `Automate` dashboard.
+To **edit an automation**, click the three dots next to the one you'd like to modify.
 
-<img src="/docs/assets/img/pro/ss-automations-dashboard-new.png" class="browser" />
+## Customizing Automations
 
-## Editing Automations
-
-To edit an automation, click the three dots next to the one you'd like to modify.
-
-<img src="/docs/assets/img/pro/ss-automations-dashboard-settings.png" class="browser" />
-
-## Automation Fields
+There are a number of customizations available to specify the specific behavior of a given automation. They are shown on the create/edit automation form below.
 
 <img src="/docs/assets/img/pro/ss-automations-automate-form.png" class="browser" />
 
-### Name
-
-A name to remember your automation by.
-
-### Git Branch
-
-The branch which will trigger your automation.  This will run your build any time someone makes a `git push` to the specified branch.
-
-### Target Platform
-
-The platform you're targeting, can be Android or iOS (for either Xcode 8 or 9)
-
-### Build Type
-
-The type of build you'd like to create. Options depend on the selected platform.
-
-### Security Profile
-
-Which security profile you'd like to use. If you have no profiles set up, you can learn more about them [here](/docs/pro/package/profiles.html).
-
-### Webhook
+### Fields
 
-(optional) If specified, we'll send a POST with information about completed builds to a webhook of your choice.  You can learn more about their content [here](/docs/pro/automation/webhooks).
+* **Name:** A name to identify the automation task.
+* **Git Branch:** The branch which will trigger the automation.  This will run a build any time a `git push` is made to the specified branch.
+* **Environment:** The [custom build environment](/docs/pro/builds/environments#custom-environments) (if any) to use when this automations is triggered.
+* **Target Platform:** The platform being targeted, can be Android or iOS (for either Xcode 8 or 9)
+* **Build Type:** The type of build to create. Options depend on the selected platform.
+* **Security Profile:** Which security profile to use. Learn more about them [here](/docs/pro/package/profiles.html).
+* **Webhook:** (optional) If specified, a POST with information about completed builds will be sent to the entered URL.  Learn more about their content [here](/docs/pro/automation/webhooks).
@@ -3,11 +3,11 @@
 Ionic Pro's automation features let you generate deliverable native builds whenever you need them. Webhooks with secure, signed download URL's and build information are also easily configurable and updatable, ensuring your app gets in the necessary hands quickly and automatically.
 
 
-## Ionic Package
+## Before Starting
 
-In order to take full advantage of automation, you first need to configure the package service.  If you haven't yet, [learn more about it here](/docs/pro/package/intro).
+To take advantage of the full power of automations, an app must be configured to use [Package Builds](/docs/pro/package/intro), as this feature is leveraged to deliver native code.
 
-## Get started
+## Using Automation
 
 * [Creating Automations](/docs/pro/automation/create)
 * [Understanding Webhooks](/docs/pro/automation/webhooks)