Merge pull request #5131 from jongio/readme-update-track2

Made the new JavaScript SDK more prominent
This commit is contained in:
Ruoxuan Wang 2019-11-26 10:09:53 +08:00 коммит произвёл GitHub
Родитель bdcf0afae4 bf754eaf4a
Коммит 6faf0dce4b
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 11 добавлений и 9 удалений

Просмотреть файл

@ -1,17 +1,19 @@
# Announcing the new Azure SDK for JavaScript
# **WARNING**
- _All_ the management plane `azure-arm-*` sdks and _most_ of the data plane `azure-*` sdks, along with the rollup package [azure](https://www.npmjs.com/package/azure) in this repository, will be deprecated in **July, 2019**. They will be replaced by JS sdks in [azure-sdk-for-js](https://github.com/azure/azure-sdk-for-js).
- The packages in [azure-sdk-for-js](https://github.com/azure/azure-sdk-for-js/tree/master/sdk) are isomorphic (can be run in the browser and on the server (node.js)) with accurate TypeScript type definitions.
- They will be actively supported moving forward.
- You will find any equivalent JS package in `@azure` org on npm for the existing node sdk package. For example: [azure-arm-compute](https://www.npmjs.com/package/azure-arm-compute) node sdk's equivalent JS sdk is [@azure/arm-compute](https://www.npmjs.com/package/@azure/arm-compute).
- _All_ the management plane sdks for the V1 Azure API (Azure Service Management) `azure-asm-*` will still be maintained from this repository. We would expect customers using these packages to move to Azure Resource Manager API packages at the earliest.
We are excited to announce that we are building a new [Azure SDK for JavaScript](https://github.com/azure/azure-sdk-for-js) in a new GitHub repo located here: https://github.com/azure/azure-sdk-for-js, which includes both Node.js and Browser support!
**NOTE:** Apart from the noticable changes in **require/import** statements, we have tried our level best to make _lesser_ breaking changes in the API calls.
The following will help you update your application to the new SDK and related packages.
### Migration
You can find more information on migrating your scripts from **node** sdk to **JS** sdk over [here](https://github.com/Azure/azure-sdk-for-js/blob/master/documentation/Migration.md).
- **Packages**:
- All of the management plane SDKs (`azure-arm-*`) and most of the data plane SDKs (`azure-*`), along with the rollup package [azure](https://www.npmjs.com/package/azure) in this repository, are deprecated as of **July, 2019**. They have been replaced by the [Azure SDK for JavaScript](https://github.com/azure/azure-sdk-for-js) packages.
- The new actively managed packages in [Azure SDK for JavaScript](https://github.com/azure/azure-sdk-for-js) support both Node.js and Browser. They also ship with TypeScript type definitions.
- All of the management plane SDKs for the V1 Azure API (Azure Service Management) `azure-asm-*` will continue to be maintained from the Azure SDK for Node.js repository. We expect customers using these packages to move to Azure Resource Manager API packages at their earliest convenience.
- **Migration**: You can find more information on migrating your code from **Azure SDK for Node.js** to the new **Azure SDK for JavaScript** in our [Migration from Node.js packages (azure-sdk-for-node) to JavaScript packages (azure-sdk-for-js)](https://github.com/Azure/azure-sdk-for-js/blob/master/documentation/Migration.md) article.
## Azure SDK for Node.js
> NOTE: This repo is being deprecated. All future JavaScript SDKs are moving to [Azure SDK for JavaScript](https://github.com/azure/azure-sdk-for-js). Please see the note above for more information.
This project provides Node.js packages that makes it easy to consume and manage Microsoft Azure Services.
If you are new to Azure and Node.js, see [Azure for Node.js developers](https://docs.microsoft.com/en-us/javascript/azure).