Merge pull request #105944 from JasonWHowell/azure-notebooks

Removing environment.yml approach in custom setup

Author: PRMerger7

articles/notebooks/configure-manage-azure-notebooks-projects.md

@@ -2,7 +2,7 @@
 title: Configure and manage Azure Notebooks Preview
 description: Learn how to manage project metadata, project files, the project's environment and setup steps through both the Azure Notebooks UI and direct terminal access.
 ms.topic: how-to
-ms.date: 05/13/2019
+ms.date: 02/28/2020
 ---
 
 # <a id="manage-and-configure-projects" /> Manage and configure projects in Azure Notebooks Preview
@@ -127,6 +127,9 @@ The information you then project depends on the type of operation you chose:
 
 - **Environment.yml**: In the second drop-down list, select an *environments.yml* file for Python projects using a conda environment.
 
+   > [!WARNING]
+   > As this is a preview service under development, there is currently a known issue where the `Environment.yml` setting does not get applied to your project as expected. The project and the Jupyter notebooks within do not load the specified environment file at present.
+
 When you're done adding steps, select **Save**.
 
 ### Use the terminal

articles/notebooks/quickstart-create-jupyter-notebook-project-environment.md

@@ -46,11 +46,14 @@ A project in Azure Notebooks is a collection of files, such as notebooks, data f
 
 1. The **+ Add** command creates a step that's defined by an operation and a target file that's selected from the files in your project. The following operations are supported:
 
-    | Operation | Description |
-    | --- | --- |
-    | Requirements.txt | Python projects define their dependencies in a requirements.txt file. With this option, select the appropriate file from the project's file list, and also select the Python version in the additional drop-down that appears. If necessary, select **Cancel** to return to the project, upload or create the file, then return to the **Project Settings** > **Environment** tab and create a new step. With this step in place, running a notebook in the project automatically runs `pip install -r <file>` |
-    | Shell script | Use to indicate a bash shell script (typically a file with the *.sh* extension) that contains any commands you wish to run to initialize the environment. |
-    | Environment.yml | A Python project that uses conda for managing an environment uses an *environments.yml* file to describe dependencies. With this option, select the appropriate file from the project's file list. |
+   | Operation | Description |
+   | --- | --- |
+   | Requirements.txt | Python projects define their dependencies in a requirements.txt file. With this option, select the appropriate file from the project's file list, and also select the Python version in the additional drop-down that appears. If necessary, select **Cancel** to return to the project, upload or create the file, then return to the **Project Settings** > **Environment** tab and create a new step. With this step in place, running a notebook in the project automatically runs `pip install -r <file>` |
+   | Shell script | Use to indicate a bash shell script (typically a file with the *.sh* extension) that contains any commands you wish to run to initialize the environment. |
+   | Environment.yml | A Python project that uses conda for managing an environment uses an *environments.yml* file to describe dependencies. With this option, select the appropriate file from the project's file list. |
+
+   > [!WARNING]
+   > As this is a preview service under development, there is currently a known issue where the `Environment.yml` setting does not get applied to your project as expected. The project and the Jupyter notebooks within do not load the specified environment file at present.
 
 1. To remove any setup step, select the **X** to the right of the step.