three notebooks quickstarts

Author: v-thepet

articles/notebooks/quickstart-clone-jupyter-notebook.md

@@ -7,15 +7,20 @@ ms.date: 12/04/2018
 
 # Quickstart: Clone a notebook in Azure Notebooks Preview
 
+In this quickstart, you create a copy of a GitHub notebook in an Azure Notebooks account. Because your Azure Notebooks clone is in the cloud, you can share it with collaborators, who need not make any local copies or even have Jupyter installed on their computers. You might also clone a notebook simply as a starting point for a project of your own, or to obtain data files. 
+
+## Prerequisites
+None.
+
+## Clone Azure Cognitive Services notebooks
+
 Many data scientists and developers store their notebooks in [GitHub repositories](https://github.com), a free service that provides storage and version control for many different project types. GitHub is often used as a means of collaborating on Jupyter notebooks that are run locally. In such cases, every collaborator maintains a local copy of the repository and runs the notebooks from that copy.
 
-Cloning creates a copy of a GitHub notebook in your Azure Notebooks account instead. This clone is independent from its original repository; changes are stored in your Azure Notebooks account only and don't affect the original. Because your clone is in the cloud, you can share the project with other collaborators who need not make any local copies or even have Jupyter installed on their own computers. You might also clone a notebook simply as a starting point for a project of your own or to obtain data files.
+Cloning creates a copy of a GitHub notebook in your Azure Notebooks account instead. This clone is independent from its original repository. Changes are stored in your Azure Notebooks account only and don't affect the original. You can share your clone with collaborators, who need not make any local copies or even have Jupyter installed on their own computers. 
 
 [!INCLUDE [notebooks-status](../../includes/notebooks-status.md)]
 
-## Clone Azure Cognitive Services notebooks
-
-1. Go to [Azure Notebooks](https://notebooks.azure.com) and sign in. (For details, see [Quickstart - Sign in to Azure Notebooks](quickstart-sign-in-azure-notebooks.md)).
+1. Go to [Azure Notebooks](https://notebooks.azure.com) and sign in. For details, see [Quickstart - Sign in to Azure Notebooks](quickstart-sign-in-azure-notebooks.md).
 
 1. From your public profile page, select **My Projects** at the top of the page:
 
@@ -64,4 +69,4 @@ Cloning creates a copy of a GitHub notebook in your Azure Notebooks account inst
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Tutorial: create an run a Jupyter notebook to do linear regression](tutorial-create-run-jupyter-notebook.md)
+> [Tutorial: Create and run a Jupyter notebook to do linear regression](tutorial-create-run-jupyter-notebook.md)

articles/notebooks/quickstart-create-share-jupyter-notebook.md

@@ -7,19 +7,22 @@ ms.date: 12/04/2018
 
 # Quickstart: Create and share a notebook in Azure Notebooks Preview
 
-In this quickstart, you learn how to quickly create and run a Jupyter notebook on Azure Notebooks, then share that notebook with others.
+In this quickstart, you create and run a Jupyter notebook on Azure Notebooks, then share that notebook with others. Jupyter, formerly IPython, lets you easily combine Markdown text, executable code, persistent data, graphics, and visualizations on one sharable canvas, the notebook. Azure Notebooks is a free hosted service to develop and run Jupyter notebooks in the cloud with no installation.
 
-[!INCLUDE [notebooks-status](../../includes/notebooks-status.md)]
+## Prerequisites
+None.
 
 ## Create a new project and notebook
 
-1. Go to the [Azure Notebooks site (https://notebooks.azure.com)](https://notebooks.azure.com) and sign in. (For details, see [Quickstart - Sign in to Azure Notebooks](quickstart-sign-in-azure-notebooks.md)).
+[!INCLUDE [notebooks-status](../../includes/notebooks-status.md)]
+
+1. Go to the [Azure Notebooks site (https://notebooks.azure.com)](https://notebooks.azure.com) and sign in. For details, see [Quickstart - Sign in to Azure Notebooks](quickstart-sign-in-azure-notebooks.md).
 
 1. From your public profile page, select **My Projects** at the top of the page:
 
     ![My Projects link on the top of the browser window](media/quickstarts/my-projects-link.png)
 
-1. On the **My Projects** page, select **+ New Project** (keyboard shortcut: n); the button may appear only as **+** if the browser window is narrow:
+1. On the **My Projects** page, select **New Project** (keyboard shortcut: n). The button may appear only as **+** if the browser window is narrow:
 
     ![New Project command on My Projects page](media/quickstarts/new-project-command.png)
 
@@ -32,7 +35,7 @@ In this quickstart, you learn how to quickly create and run a Jupyter notebook o
 
      ![New Project popup with populated details](media/quickstarts/new-project-popup.png)
 
-1. After a few moments, Azure Notebooks navigates you to the new project. Add a notebook to the project by selecting the **+ New** drop-down (which may appear as only **+**), then selecting **Notebook**:
+1. After a few moments, Azure Notebooks navigates you to the new project. Add a notebook to the project by selecting the **New** drop-down (which may appear as only **+**), then selecting **Notebook**:
 
     [![](media/quickstarts/empty-project-new-notebook-button.png "A new, empty project and add notebook command")](media/quickstarts/empty-project-new-notebook-button.png#lightbox)
 
@@ -97,4 +100,4 @@ On the project page, you can also use the **Share** menu to obtain a link, creat
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Tutorial: create an run a Jupyter notebook to do linear regression](tutorial-create-run-jupyter-notebook.md)
+> [Tutorial: Create and run a Jupyter notebook to do linear regression](tutorial-create-run-jupyter-notebook.md)

articles/notebooks/quickstart-migrate-local-jupyter-notebook.md

@@ -7,23 +7,26 @@ ms.date: 12/04/2018
 
 # Quickstart: Migrate a local Jupyter notebook in Azure Notebooks Preview
 
-Jupyter notebooks that you create locally on your own computer are accessible only to you. You can share your files through a variety of means, but then recipients have their own local copy of the notebook and it's difficult for you to incorporate any changes they might make. You can also store notebooks in a shared online repository such as GitHub, but doing so still requires that each collaborator has their own local Jupyter installation with the same configuration as yours.
+In this quickstart, you migrate a Jupyter notebook from your local computer or another accessible file URL to Azure Notebooks. You can instantly share your Azure Notebook project with your collaborators, who need only a browser to view and run your notebook. If they sign in to Azure Notebooks, they can also make changes.
 
-By migrating your local or repository-based notebooks to Azure Notebooks, you store them in the cloud from which you can instantly share them with your collaborators. Those collaborators need only a browser to view and run your notebook, and if they [sign in](quickstart-sign-in-azure-notebooks.md) to Azure Notebooks they can also make changes.
+## Prerequisites
+- A [Jupyter notebook](https://jupyter.org/) on your local computer or at another accessible file URL. 
 
-[!INCLUDE [notebooks-status](../../includes/notebooks-status.md)]
+## Create a project on Azure Notebooks
 
-This Quickstart demonstrates the process of migrating a notebook from your local computer or another accessible file URL. To migrate notebooks from a GitHub repository, see [Quickstart: Clone a notebook](quickstart-clone-jupyter-notebook.md).
+Jupyter notebooks that you create locally on your own computer are accessible only to you. You can share your files through a variety of means, but then recipients have their own local copy of the notebook and it's difficult for you to incorporate any changes they might make. You can also store notebooks in a shared online repository such as GitHub, but doing so still requires that each collaborator has their own local Jupyter installation with the same configuration as yours. By migrating your local or repository-based notebooks to Azure Notebooks, you store them in the cloud, from which you can instantly share them with your collaborators. 
 
-## Create a project on Azure Notebooks
+This quickstart demonstrates migrating a notebook from your local computer or another accessible file URL. To migrate notebooks from a GitHub repository, see [Quickstart: Clone a notebook](quickstart-clone-jupyter-notebook.md).
+
+[!INCLUDE [notebooks-status](../../includes/notebooks-status.md)]
 
 1. Go to [Azure Notebooks](https://notebooks.azure.com) and sign in. (For details, see [Quickstart - Sign in to Azure Notebooks](quickstart-sign-in-azure-notebooks.md)).
 
 1. From your public profile page, select **My Projects** at the top of the page:
 
     ![My Projects link on the top of the browser window](media/quickstarts/my-projects-link.png)
 
-1. On the **My Projects** page, select **+ New Project** (keyboard shortcut: n); the button may appear only as **+** if the browser window is narrow:
+1. On the **My Projects** page, select **New Project** (keyboard shortcut: n). The button may appear only as **+** if the browser window is narrow:
 
     ![New Project command on My Projects page](media/quickstarts/new-project-command.png)
 
@@ -35,13 +38,13 @@ This Quickstart demonstrates the process of migrating a notebook from your local
 
     ![Command to upload a notebook from a URL or the local computer](media/quickstarts/upload-from-computer-url-command.png)
 
-   (Again, if your notebook is in a GitHub repository, follow the steps on [Quickstart: Clone a notebook](quickstart-clone-jupyter-notebook.md) instead.)
+   Again, if your notebook is in a GitHub repository, follow the steps on [Quickstart: Clone a notebook](quickstart-clone-jupyter-notebook.md) instead.
 
-   - If using **From Computer**, drag and drop your *.ipynb* files into the popup, or select **Choose Files**, then browse to and select the files you want to import. Then select **Upload**. The uploaded files are given the same name as the local files. (You don't need to upload the contents of any *.ipynb_checkpoints* folders.)
+   - If using **From Computer**, drag and drop your *.ipynb* files into the popup, or select **Choose Files**, then browse to and select the files you want to import. Then select **Upload**. The uploaded files are given the same name as the local files. You don't need to upload the contents of any *.ipynb_checkpoints* folders.
 
      ![Upload from computer popup](media/quickstarts/upload-from-computer-popup.png)
 
-   - If using **From URL**, enter the source address in the **File URL** field and the filename to assign to the notebook in your project in the **File Name** field. Then select **Upload**. If you have multiple files with separate URLs, use the **+ Add File** command to check the first URL you entered, after which the popup provides new fields for another file.
+   - If using **From URL**, enter the source address in the **File URL** field and the filename to assign to the notebook in your project in the **File Name** field. Then select **Upload**. If you have multiple files with separate URLs, use the **Add File** command to check the first URL you entered, after which the popup provides new fields for another file.
 
      ![Upload from URL popup](media/quickstarts/upload-from-url-popup.png)
 
@@ -54,4 +57,4 @@ This Quickstart demonstrates the process of migrating a notebook from your local
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Tutorial: create an run a Jupyter notebook to do linear regression](tutorial-create-run-jupyter-notebook.md)
+> [Tutorial: Create and run a Jupyter notebook to do linear regression](tutorial-create-run-jupyter-notebook.md)