diff --git a/README.md b/README.md index 8d26ae080bda..6d8c98e069a1 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,13 @@ [![Build Status](https://travis-ci.org/Azure/azure-sdk-for-java.svg?style=flat-square&label=build)](https://travis-ci.org/Azure/azure-sdk-for-java) -#Microsoft Azure SDK for Java +#Azure Management Libraries for Java -This project provides a client library in Java that makes it easy to consume Microsoft Azure services. For documentation please see the [JavaDocs](http://azure.github.io/azure-sdk-for-java). For a list of libraries and how they are organized, please see the [Azure SDK for Java Features Wiki page] (https://github.com/Azure/azure-sdk-for-java/wiki/Azure-SDK-for-Java-Features). +This project provides a new, simplified Azure management libraries for Java. Our goal is to improve the developer experience by providing a higher-level, object-oriented API, optimized for readability and writability. -#Download +For documentation please see the [Javadoc](http://azure.github.io/azure-sdk-for-java). + +For a list of libraries and how they are organized, please see the [Azure Management Libraries for Java Features Wiki page] (https://github.com/Azure/azure-sdk-for-java/wiki/Azure-SDK-for-Java-Features). + +#[EDIT THIS] Download **Notes:** If you are using snapshots builds from beta1 we recommend going to http://adxsnapshots.azurewebsites.net/ and find the exact version number. The latest beta1 snapshot versions are - client-runtime: 1.0.0-20160513.000825-29 - azure-client-runtime: 1.0.0-20160513.000812-28 @@ -35,7 +39,7 @@ repositories { #Getting Started You will need Java v1.7+. If you would like to develop on the SDK, you will also need maven. -## Azure Resource Manager (ARM) Usage +## [EDIT THIS] Azure Resource Manager (ARM) Usage ```java ResourceManagementClient client = new ResourceManagementClientImpl( new ApplicationTokenCredentials("client-id", "tenant-id", "secret", null) // see Authentication @@ -48,7 +52,7 @@ group.setLocation("West US"); client.getResourceGroups().createOrUpdate("myresourcegroup", group); ``` -### Authentication +### [EDIT THIS] Authentication The first step to using the SDK is authentication and permissioning. For people unfamilar with Azure this may be one of the more difficult concepts. For a reference on setting up a service principal from the command line see [Authenticating a service principal with Azure Resource Manager](http://aka.ms/cli-service-principal) or [Unattended Authentication](http://aka.ms/auth-unattended). For a more robust explanation of authentication in Azure, see [Developer’s guide to auth with Azure Resource Manager API](http://aka.ms/arm-auth-dev-guide). After creating the service principal, you should have three pieces of information, a client id (GUID), client secret (string) and tenant id (GUID) or domain name (string). By feeding them into the `ApplicationTokenCredentials` and initialize the ARM client with it, you should be ready to go. @@ -67,4 +71,10 @@ If you would like to become an active contributor to this project please follow 5. Create new Pull Request #Learn More -* [JavaDocs](http://azure.github.io/azure-sdk-for-java) +* [Javadoc](http://azure.github.io/azure-sdk-for-java) +* [http://azure.com/java](http://azure.com/java) +* If you don't have a Microsoft Azure subscription you can get a FREE trial account [here](http://go.microsoft.com/fwlink/?LinkId=330212) + +--- + +This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. \ No newline at end of file