Merge pull request #105938 from rwike77/migration

adding overview

Author: GitHubber17

articles/active-directory/develop/TOC.yml

@@ -29,9 +29,9 @@
       href: quickstart-v2-javascript.md
   - name: Web apps
     items:
-    - name: ASP .NET
+    - name: ASP.NET
       href: quickstart-v2-aspnet-webapp.md
-    - name: ASP .NET Core
+    - name: ASP.NET Core
       href: quickstart-v2-aspnet-core-webapp.md
     - name: NodeJS
       href: quickstart-v2-nodejs-webapp.md
@@ -42,9 +42,9 @@
       href: quickstart-v2-python-webapp.md
   - name: Web APIs
     items:
-    - name: ASP .NET
+    - name: ASP.NET
       href: quickstart-v2-dotnet-native-aspnet.md
-    - name: ASP .NET Core
+    - name: ASP.NET Core
       href: https://azure.microsoft.com/resources/samples/active-directory-dotnet-native-aspnetcore-v2
   - name: Mobile and desktop apps
     items:
@@ -70,7 +70,7 @@
       href: tutorial-v2-javascript-spa.md
   - name: Web apps
     items:
-    - name: ASP .NET
+    - name: ASP.NET
       href: tutorial-v2-asp-webapp.md
   - name: Mobile and desktop apps
     items:
@@ -242,13 +242,15 @@
       href: brokered-auth.md
     - name: Migration
       items:
+      - name: Overview
+        href: msal-migration.md
       - name: Migrate to MSAL.NET
         href: msal-net-migration.md
       - name: Migrate to MSAL.js
         href: msal-compare-msal-js-and-adal-js.md
       - name: Migrate to MSAL.Android
         href: migrate-android-adal-msal.md
-      - name: Migrate to MSAL.iOS / MacOS
+      - name: Migrate to MSAL.iOS / macOS
         href: migrate-objc-adal-msal.md
       - name: Migrate to MSAL Python
         href: migrate-python-adal-msal.md

articles/active-directory/develop/msal-migration.md

@@ -0,0 +1,38 @@
+---
+title: Migrate to Microsoft Authentication Library (MSAL)
+titleSuffix: Microsoft identity platform
+description: Learn about the differences between Microsoft Authentication Library (MSAL) and Azure AD Authentication Library (ADAL) and how to migrate to MSAL.
+services: active-directory
+author: jmprieur
+manager: CelesteDG
+
+ms.service: active-directory
+ms.subservice: develop
+ms.topic: conceptual
+ms.workload: identity
+ms.date: 02/27/2020
+ms.author: jmprieur
+ms.reviewer: saeeda
+ms.custom: aaddev
+#Customer intent: As an application developer, I want to learn about the differences between the ADAL and MSAL libraries so I can migrate my applications to MSAL.
+---
+
+# Migrate applications to Microsoft Authentication Library (MSAL)
+
+Both Microsoft Authentication Library (MSAL) and Azure AD Authentication Library (ADAL) are used to authenticate Azure AD entities and request tokens from Azure AD. Up until now, most developers have worked with Azure AD for developers platform (v1.0) to authenticate Azure AD identities (work and school accounts) by requesting tokens using Azure AD Authentication Library (ADAL). Using MSAL:
+
+- You can authenticate a broader set of Microsoft identities (Azure AD identities and Microsoft accounts, and social and local accounts through Azure AD B2C) as it uses the Microsoft identity platform endpoint.
+- Your users will get the best single-sign-on experience.
+- Your application can enable incremental consent, and supporting Conditional Access is easier.
+- You benefit from the innovation.
+
+**MSAL is now the recommended auth library to use with the Microsoft identity platform**. No new features will be implemented on ADAL. The efforts are focused on improving MSAL.
+
+The following articles describe the differences between the MSAL and ADAL libraries and help you migrate to MSAL:
+- [Migrate to MSAL.NET](msal-net-migration.md)
+- [Migrate to MSAL.js](msal-compare-msal-js-and-adal-js.md)
+- [Migrate to MSAL.Android](migrate-android-adal-msal.md)
+- [Migrate to MSAL.iOS / macOS](migrate-objc-adal-msal.md)
+- [Migrate to MSAL Python](migrate-python-adal-msal.md)
+- [Migrate to MSAL for Java](migrate-adal-msal-java.md)
+- [Migrate Xamarin apps using brokers to MSAL.NET](msal-net-migration-ios-broker.md)