Merge pull request MicrosoftDocs#36743 from edburns/edburns-20190807-marketplace-edits

ktoliver · web-flow · commit 1537b8f24ca7 · 2019-08-08T09:38:51.000-07:00
Edburns 20190807 marketplace edits
diff --git a/articles/marketplace/cloud-partner-portal/cpp-marketplace-offers.md b/articles/marketplace/cloud-partner-portal/cpp-marketplace-offers.md
@@ -13,7 +13,7 @@ ms.author: pabutler
 
 This first part of this section introduces the general operations used to create and manage offers for the Azure and AppSource Marketplaces.  This part provides the background you need to understand to manage specific offer types, as well as technical information that is common to all offer types.  The majority of this section contains detailed instructions on how to create and manage specific offer types.  
 
-The following video introduces the various capabilities and different offers types available in Azure Marketplace or AppSource.  It also covers important technical and business aspects of publishing an application or service in these marketplaces.
+The following video introduces the various capabilities and different offer types available in Azure Marketplace or AppSource.  It also covers important technical and business aspects of publishing an application or service in these marketplaces.
 
 > [!VIDEO https://channel9.msdn.com/Events/Build/2018/BRK2513/player]
 
@@ -46,7 +46,7 @@ The following table lists the current offer types supported by the [Cloud Partne
 | [Dynamics 365 Business Central](../cloud-partner-portal-orig/cpp-business-central-offer.md) | AppSource | A package that extends this enterprise resource planning (ERP) and business management system. |
 | [Dynamics 365 for Customer Engagement](./dyn365ce/cpp-customer-engagement-offer.md) | AppSource | A package that extends this customer resource management (CRM) system, through its sales, service, project service, and field service modules  |
 | [Dynamics 365 for Finance and Operations](../cloud-partner-portal-orig/cpp-dynamics-365-operations-offer.md) | AppSource | A package that extends this enterprise resource planning (ERP) service that supports advanced finance, operations, manufacturing, and supply chain management |
-| [IoT Edge module](./iot-edge-module/cpp-offer-process-parts.md) | Azure | A Docker-compatible container that runs on an IoT Edge device.  It contains of    Small computational modules that use a combination of custom code, other Azure services, and 3rd-party services. |
+| [IoT Edge module](./iot-edge-module/cpp-offer-process-parts.md) | Azure | A Docker-compatible container that runs on an IoT Edge device.  It consists of    Small computational modules that use a combination of custom code, other Azure services, and 3rd-party services. |
 | [Power BI App](./power-bi/cpp-power-bi-offer.md) | AppSource | A Power BI app that packages customizable Power BI content including datasets, reports, and dashboards |
 | [SaaS app](./saas-app/cpp-saas-offer.md) | Azure | Solution is a software-as-a-service subscription, managed by the publisher, which users sign in through a customized interface that uses Azure Active Directory. |
 | [Virtual machine](./virtual-machine/cpp-virtual-machine-offer.md)  | Azure  | Solution is contained within a single virtual machine deployed to the customer's subscription.  |
diff --git a/articles/marketplace/cloud-partner-portal/virtual-machine/cpp-configure-vm.md b/articles/marketplace/cloud-partner-portal/virtual-machine/cpp-configure-vm.md
@@ -65,7 +65,7 @@ For more information about running sysprep, see [Steps to generalize a VHD](http
 
 ### Linux
 
-Following two-step process will generalize a Linux VM and redeploy it as a separate VM.  For more information, see [How to create an image of a virtual machine or VHD](../../../virtual-machines/linux/capture-image.md). 
+The following two-step process generalizes a Linux VM and redeploys it as a separate VM. These two steps are just the essentials of the process. For more information about these two steps and why they must be done, see [How to create an image of a virtual machine or VHD](../../../virtual-machines/linux/capture-image.md). For the purposes of creating the VHD for your Azure Marketplace offer, you can stop when you reach the section "Create a VM from the captured image".
 
 #### Remove the Azure Linux agent
 1.  Connect to your Linux VM using an SSH client.
@@ -90,4 +90,4 @@ Creating copies of VM is often useful for backup, testing, customized fail-over
 
 ## Next steps
 
-After your VM is configured, you are ready to [deploy a virtual machine from a virtual hard disk](./cpp-deploy-vm-vhd.md).
+After your VM is generalized, has been deallocated, and you have created an image of the VM, you are ready to [deploy a virtual machine from a virtual hard disk](./cpp-deploy-vm-vhd.md).
diff --git a/articles/marketplace/cloud-partner-portal/virtual-machine/cpp-create-technical-assets.md b/articles/marketplace/cloud-partner-portal/virtual-machine/cpp-create-technical-assets.md
@@ -29,7 +29,7 @@ You must configure the VM OS, the VM size, ports to open, and up to 15 attached
 
 ## Fundamental technical knowledge
 
-Designing, building, and testing these assets take time and requires technical knowledge of both the Azure platform and the technologies used to build the offer. In addition to your solution domain, your engineering team should have knowledge on the following Microsoft technologies: 
+Designing, building, and testing these assets takes time and requires technical knowledge of both the Azure platform and the technologies used to build the offer. In addition to your solution domain, your engineering team should have knowledge of the following Microsoft technologies: 
 -	Basic understanding of [Azure Services](https://azure.microsoft.com/services/) 
 -	How to [design and architect Azure applications](https://azure.microsoft.com/solutions/architecture/)
 -	Working knowledge of [Azure Virtual Machines](https://azure.microsoft.com/services/virtual-machines/), [Azure Storage](https://azure.microsoft.com/services/?filter=storage) and [Azure Networking](https://azure.microsoft.com/services/?filter=networking)
diff --git a/articles/virtual-machines/linux/capture-image.md b/articles/virtual-machines/linux/capture-image.md
@@ -36,9 +36,9 @@ You'll need the following items before creating an image:
 
 * The latest [Azure CLI](/cli/azure/install-az-cli2) installed and be logged in to an Azure account with [az login](/cli/azure/reference-index#az-login).
 
-## Quick commands
+## Prefer a tutorial instead?
 
-For a simplified version of this article, and for testing, evaluating, or learning about VMs in Azure, see [Create a custom image of an Azure VM by using the CLI](tutorial-custom-images.md).
+For a simplified version of this article, and for testing, evaluating, or learning about VMs in Azure, see [Create a custom image of an Azure VM by using the CLI](tutorial-custom-images.md).  Otherwise, keep reading here to get the full picture.
 
 
 ## Step 1: Deprovision the VM
@@ -54,7 +54,7 @@ First you'll deprovision the VM by using the Azure VM agent to delete machine-sp
    > Only run this command on a VM that you'll capture as an image. This command does not guarantee that the image is cleared of all sensitive information or is suitable for redistribution. The `+user` parameter also removes the last provisioned user account. To keep user account credentials in the VM, use only `-deprovision`.
  
 3. Enter **y** to continue. You can add the `-force` parameter to avoid this confirmation step.
-4. After the command completes, enter **exit** to close the SSH client.
+4. After the command completes, enter **exit** to close the SSH client.  The VM will still be running at this point.
 
 ## Step 2: Create VM image
 Use the Azure CLI to mark the VM as generalized and capture the image. In the following examples, replace example parameter names with your own values. Example parameter names include *myResourceGroup*, *myVnet*, and *myVM*.
@@ -67,7 +67,7 @@ Use the Azure CLI to mark the VM as generalized and capture the image. In the fo
 	  --name myVM
     ```
 	
-	Wait for the VM to completely deallocate before moving on. This may take a few minutes to complete.
+	Wait for the VM to completely deallocate before moving on. This may take a few minutes to complete.  The VM is shut down during deallocation.
 
 2. Mark the VM as generalized with [az vm generalize](/cli/azure/vm). The following example marks the VM named *myVM* in the resource group named *myResourceGroup* as generalized.
    
@@ -77,6 +77,8 @@ Use the Azure CLI to mark the VM as generalized and capture the image. In the fo
 	  --name myVM
     ```
 
+	A VM that has been generalized can no longer be restarted.
+
 3. Create an image of the VM resource with [az image create](/cli/azure/image#az-image-create). The following example creates an image named *myImage* in the resource group named *myResourceGroup* using the VM resource named *myVM*.
    
     ```azurecli
@@ -89,6 +91,8 @@ Use the Azure CLI to mark the VM as generalized and capture the image. In the fo
    > The image is created in the same resource group as your source VM. You can create VMs in any resource group within your subscription from this image. From a management perspective, you may wish to create a specific resource group for your VM resources and images.
    >
    > If you would like to store your image in zone-resilient storage, you need to create it in a region that supports [availability zones](../../availability-zones/az-overview.md) and include the `--zone-resilient true` parameter.
+   
+This command returns JSON that describes the VM image. Save this output for later reference.
 
 ## Step 3: Create a VM from the captured image
 Create a VM by using the image you created with [az vm create](/cli/azure/vm). The following example creates a VM named *myVMDeployed* from the image named *myImage*.
