finish migration docs; add to v1 toc

Author: sdgilley

articles/machine-learning/how-to-migrate-from-v1.md

@@ -8,7 +8,7 @@ ms.subservice: core
 ms.topic: how-to
 author: s-polly
 ms.author: scottpolly
-ms.date: 06/01/2022
+ms.date: 09/23/2022
 ms.reviewer: blackmist
 ms.custom: devx-track-azurecli, devplatv2
 ---
@@ -84,11 +84,14 @@ Do consider migrating the code for creating a workspace to v2. Typically Azure r
 > [!IMPORTANT]
 > If your workspace uses a private endpoint, it will automatically have the `v1_legacy_mode` flag enabled, preventing usage of v2 APIs. See [how to configure network isolation with v2](how-to-configure-network-isolation-with-v2.md) for details.
 
+
 ### Connection (workspace connection in v1)
 
 Workspace connections from v1 are persisted on the workspace, and fully available with v2.
 
 We recommend migrating the code for creating connections to v2.
+For a comparison of SDK v1 and v2 code, see [Migrate workspace management from SDK v1 to SDK v2](migrate-to-v2-resource-workspace.md).
+
 
 ### Datastore
 
@@ -114,6 +117,8 @@ You can continue using your existing v1 model deployments. For new model deploym
 |Azure Kubernetes Service (AKS)|ACI, AKS|Manage your own AKS cluster(s) for model deployment, giving flexibility and granular control at the cost of IT overhead.|
 |Azure Arc Kubernetes|N/A|Manage your own Kubernetes cluster(s) in other clouds or on-premises, giving flexibility and granular control at the cost of IT overhead.|
 
+For a comparison of SDK v1 and v2 code, see [Migrate deployment endpoints from SDK v1 to SDK v2](migrate-to-v2-deploy-endpoints.md).
+
 ### Jobs (experiments, runs, pipelines in v1)
 
 In v2, "experiments", "runs", and "pipelines" are consolidated into jobs. A job has a type. Most jobs are `command` jobs that run a command, like `python main.py`. What runs in a job is agnostic to any programming language, so you can run `bash` scripts, invoke `python` interpreters, run a bunch of `curl` commands, or anything else. Another common type of job is `pipeline`, which defines child jobs that may have input/output relationships, forming a directed acyclic graph (DAG).
@@ -126,6 +131,8 @@ What you run *within* the job does not need to be migrated to v2. However, it is
 
 We recommend migrating the code for creating jobs to v2. You can see [how to train models with the CLI (v2)](how-to-train-cli.md) and the [job YAML references](reference-yaml-job-command.md) for authoring jobs in v2 YAMLs.
 
+For a comparison of SDK v1 and v2 code, see [Migrate script run from SDK v1 to SDK v2](migrate-to-v2-command-job.md).
+
 ### Data (datasets in v1)
 
 Datasets are renamed to data assets. Interoperability between v1 datasets and v2 data assets is the most complex of any entity in Azure ML.
@@ -136,18 +143,34 @@ For details on data in v2, see the [data concept article](concept-data.md).
 
 We recommend migrating the code for [creating data assets](how-to-create-data-assets.md) to v2.
 
+For a comparison of SDK v1 and v2 code, see [Migrate data management from SDK v1 to v2](migrate-to-v2-assets-data.md).
+
+
 ### Model
 
 Models created from v1 can be used in v2. In v2, explicit model types are introduced. Similar to data assets, it may be easier to re-create a v1 model as a v2 model, setting the type appropriately.
 
 We recommend migrating the code for creating models with [SDK](how-to-train-sdk.md) or [CLI](how-to-train-cli.md) to v2.
 
+For a comparison of SDK v1 and v2 code, see 
+
+* [Migrate model management from SDK v1 to SDK v2](migrate-to-v2-assets-model.md)
+* [Migrate AutoML from SDK v1 to SDK v2](migrate-to-v2-execution-automl.md)
+* [Migrate hyperparameter tuning from SDK v1 to SDK v2](migrate-to-v2-execution-hyperdrive.md)
+* [Migrate parallel run step from SDK v1 to SDK v2](migrate-to-v2-execution-parallel-run-step.md)
+
 ### Environment
 
 Environments created from v1 can be used in v2. In v2, environments have new features like creation from a local Docker context.
 
 We recommend migrating the code for creating environments to v2.
 
+## Managing secrets
+
+The management of Key Vault secrets differs significantly in V2 compared to V1. The V1 set_secret and get_secret SDK methods are not available in V2. Instead, direct access using Key Vault client libraries should be used.
+
+For details about Key Vault, see [Use authentication credential secrets in Azure Machine Learning training jobs](how-to-use-secrets-in-runs.md).
+
 ## Scenarios across the machine learning lifecycle
 
 There are a few scenarios that are common across the machine learning lifecycle using Azure ML. We'll look at a few and give general recommendations for migrating to v2.
@@ -182,7 +205,7 @@ A MLOps workflow typically involves CI/CD through an external tool. It's recomme
 
 The solution accelerator for MLOps with v2 is being developed at https://github.com/Azure/mlops-v2 and can be used as reference or adopted for setup and automation of the machine learning lifecycle.
 
-#### A note on GitOps with v2
+### A note on GitOps with v2
 
 A key paradigm with v2 is serializing machine learning entities as YAML files for source control with `git`, enabling better GitOps approaches than were possible with v1. For instance, you could enforce policy by which only a service principal used in CI/CD pipelines can create/update/delete some or all entities, ensuring changes go through a governed process like pull requests with required reviewers. Since the files in source control are YAML, they're easy to diff and track changes over time. You and your team may consider shifting to this paradigm as you migrate to v2.
 

articles/machine-learning/v1/toc.yml

@@ -7,20 +7,50 @@
   - name: Architecture & terms 
     displayName: architecture, concepts, definitions, glossary
     href: concept-azure-machine-learning-architecture.md
-  - name: Migrate from ML Studio (classic)
-    items: 
+
+- name: Migration from v1 to v2
+  items:
     - name: Migration overview
-      href: ../migrate-overview.md
-    - name: Migrate datasets
-      href: ../migrate-register-dataset.md
-    - name: Rebuild experiments
-      href: ../migrate-rebuild-experiment.md
-    - name: Rebuild web services
-      href: ../migrate-rebuild-web-service.md
-    - name: Migrate client applications
-      href: ../migrate-rebuild-integrate-with-client-app.md
-    - name: Rebuild Execute R Script components
-      href: ../migrate-execute-r-script.md
+      displayName: migration
+      href: ../how-to-migrate-from-v1.md
+    - name: Manage resources and assets
+      items:
+      - name: "Workspace"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-resource-workspace.md
+      - name: "Datastore"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-resource-datastore.md
+      - name: "Data assets"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-assets-data.md
+      - name: "Model assets"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-assets-model.md
+      - name: Train a model
+        items:
+      - name: "Run a script"
+        displayName: migration, v1, v2
+        href: ../-to-v2-command-job.md
+      - name: "Local runs"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-local-runs.md
+      - name: "AutoML"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-execution-automl.md
+      - name: "Hyperparameter tuning"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-execution-hyperdrive.md
+      - name: "Parallel run step"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-execution-parallel-run-step.md  
+      - name: "Pipelines"
+        displayName: migration, v1, v2
+        href: ../migrate-to-v2-execution-pipeline.md  
+    - name: "Deploy endpoints"
+      displayName: migration, v1, v2
+      href: ../migrate-to-v2-deploy-endpoints.md  
+
 - name: Concepts (v1)
   items:
   - name: Model training
@@ -327,6 +357,20 @@
           href: how-to-debug-parallel-run-step.md
 - name: Reference (v1)
   items: 
+  - name: Migrate from ML Studio (classic)
+    items: 
+    - name: Migration overview
+      href: ../migrate-overview.md
+    - name: Migrate datasets
+      href: ../migrate-register-dataset.md
+    - name: Rebuild experiments
+      href: ../migrate-rebuild-experiment.md
+    - name: Rebuild web services
+      href: ../migrate-rebuild-web-service.md
+    - name: Migrate client applications
+      href: ../migrate-rebuild-integrate-with-client-app.md
+    - name: Rebuild Execute R Script components
+      href: ../migrate-execute-r-script.md
   - name: Machine learning CLI pipeline YAML reference
     href: reference-pipeline-yaml.md
   - name: Hyperparameters for AutoML computer vision tasks (v1)