minor cleanup

docs-ref-conceptual/java-sdk-azure-authenticate.md

@@ -113,7 +113,7 @@ Save this file in a secure location on your system where your code can read it.
 AZURE_AUTH_LOCATION=/Users/raisa/azureauth.properties
 ```
 
-Create the entry point `Azure` object to start working with the API:
+Create the entry point `Azure` object to start working with the libraries:
 
 ```java
 // pull in the location of the authenticaiton properties file from the environment 

docs-ref-conceptual/java-sdk-azure-concepts.md

@@ -131,11 +131,11 @@ PublicIPAddress pip = (PublicIPAddress) virtualMachine.createdRelatedResource(pu
 
 ## Exception handling
 
-The management API currently defines Exception classes that extend `com.microsoft.rest.RestException`. Catch exceptions generated by management API, with a `catch (RestException exception)` block after the relevant `try` statement.
+The management libraries currently defines Exception classes that extend `com.microsoft.rest.RestException`. Catch exceptions generated by management libraries, with a `catch (RestException exception)` block after the relevant `try` statement.
 
 ## Logs and trace
 
-Configure the amount of logging from the management API when you build the entry point `Azure` object using `withLogLevel()`. The following trace levels exist:
+Configure the amount of logging from the management library when you build the entry point `Azure` object using `withLogLevel()`. The following trace levels exist:
 
 | Trace level | Logging enabled 
 | ------------ | ---------------

docs-ref-conceptual/java-sdk-azure-get-started.md

@@ -222,7 +222,7 @@ Replace the main method in `AzureApp.java` with the code below, setting a real v
 
     public static void main(String args[])
     {
-        // create the db using the management api
+        // create the db using the management libraries
         try {
             final File credFile = new File(System.getenv("AZURE_AUTH_LOCATION"));
             Azure azure = Azure.configure()

docs-ref-conceptual/java-sdk-azure-install.md

@@ -41,7 +41,7 @@ Other Java build tools like Gradle are supported but the install steps are not p
 
 ## Azure service libraries
 
-Integrate Azure services to add functionality to your apps using these libraries. Learn more about building apps with Azure services at [Azure for Java developers](https://review.docs.microsoft.com/en-us/azure/java/index?branch=pr-en-us-9782).
+Integrate Azure services to add functionality to your apps using these libraries. Learn more about building apps with Azure services at [Azure for Java developers]().
 
 <a name="azure-storage"></a>
 
@@ -61,7 +61,7 @@ Data storage and messaging for your applications.
 
 <a name="sql-database"></a>
 
-### [SQL Database](https://docs.microsoft.com/en-us/azure/sql-database/sql-database-technical-overview)
+### [SQL Database](https://docs.microsoft.com/azure/sql-database/sql-database-technical-overview)
 
 JDBC driver for Azure SQL Database.
 
@@ -73,11 +73,11 @@ JDBC driver for Azure SQL Database.
 </dependency>
 ```
 
-[Samples](https://docs.microsoft.com/en-us/sql/connect/jdbc/step-3-proof-of-concept-connecting-to-sql-using-java) | [Reference](overview.md) | [GitHub](https://github.com/Microsoft/mssql-jdbc)  | [Release Notes](https://github.com/Microsoft/mssql-jdbc/blob/master/CHANGELOG.md)
+[Samples](https://docs.microsoft.com/sql/connect/jdbc/step-3-proof-of-concept-connecting-to-sql-using-java) | [Reference](overview.md) | [GitHub](https://github.com/Microsoft/mssql-jdbc)  | [Release Notes](https://github.com/Microsoft/mssql-jdbc/blob/master/CHANGELOG.md)
 
 <a name="redis-cache"></a>
 
-### [Redis Cache](https://azure.microsoft.com/en-us/services/cache/)
+### [Redis Cache](https://azure.microsoft.com/services/cache/)
 
 Low-latency, high-performance key-value store.
 
@@ -91,7 +91,7 @@ Low-latency, high-performance key-value store.
 </dependency>
 ```   
 
-[Samples](https://docs.microsoft.com/en-us/azure/redis-cache/cache-java-get-started) | [Reference](http://xetorthio.github.io/jedis)  | [GitHub](https://github.com/xetorthio/jedis)  | [Release Notes](https://github.com/xetorthio/jedis/releases)  
+[Samples](https://docs.microsoft.com/azure/redis-cache/cache-java-get-started) | [Reference](http://xetorthio.github.io/jedis)  | [GitHub](https://github.com/xetorthio/jedis)  | [Release Notes](https://github.com/xetorthio/jedis/releases)  
 
 <a name="documentdb"></a>
 
@@ -107,11 +107,11 @@ Scalable NoSQL database with JSON documents and a SQL or JavaScript query syntax
 </dependency>
 ```
 
-[Samples](https://docs.microsoft.com/en-us/azure/documentdb/documentdb-java-application) | [Reference](overview.md) | [GitHub](https://github.com/Azure/azure-documentdb-java)   | [Release Notes](https://github.com/Azure/azure-documentdb-java/blob/master/changelog.md)
+[Samples](https://docs.microsoft.com/azure/documentdb/documentdb-java-application) | [Reference](overview.md) | [GitHub](https://github.com/Azure/azure-documentdb-java)   | [Release Notes](https://github.com/Azure/azure-documentdb-java/blob/master/changelog.md)
 
 <a name="servicebus"></a>
 
-### [Service Bus](https://docs.microsoft.com/en-us/azure/service-bus-messaging/service-bus-fundamentals-hybrid-solutions)
+### [Service Bus](https://docs.microsoft.com/azure/service-bus-messaging/service-bus-fundamentals-hybrid-solutions)
 
 Java Message Service (JMS) support through [AMQP](https://en.wikipedia.org/wiki/Advanced_Message_Queuing_Protocol) to connect your applications.
 
@@ -159,7 +159,7 @@ Safely access keys and secrets from your applications.
 
 <a name="eventhub"></a>
 
-### [Event Hub](https://docs.microsoft.com/en-us/azure/event-hubs/event-hubs-what-is-event-hubs) 
+### [Event Hub](https://docs.microsoft.com/azure/event-hubs/event-hubs-what-is-event-hubs) 
    
 High throughput event and telemetry handling for your instrumentation or IoT scenarios.
 
@@ -235,11 +235,11 @@ Track usage, add telemetry, and monitor your web apps.
 </dependency>
 ```
 
-[Samples](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-java-get-started) | [Reference](overview.md) | [GitHub](https://github.com/Microsoft/ApplicationInsights-Java) | [Release Notes](https://github.com/Microsoft/ApplicationInsights-Java#to-upgrade-to-the-latest-sdk)
+[Samples](https://docs.microsoft.com/azure/application-insights/app-insights-java-get-started) | [Reference](overview.md) | [GitHub](https://github.com/Microsoft/ApplicationInsights-Java) | [Release Notes](https://github.com/Microsoft/ApplicationInsights-Java#to-upgrade-to-the-latest-sdk)
 
 <a name="batch"></a>
 
-### [Batch](https://docs.microsoft.com/en-us/azure/batch)
+### [Batch](https://docs.microsoft.com/azure/batch)
 
 Run large-scale parallel and high-performance computing applications efficiently in the cloud.
 

docs-ref-conceptual/java-sdk-manage-vm-scalesets.md

@@ -228,7 +228,7 @@ Scale the number of virtual machines in the scale set using `withCapacity()` and
 | [VirtualMachineScaleSet](https://docs.microsoft.com/java/api/com.microsoft.azure.management.compute._virtual_machine_scale_set) | Query, start, stop, update and delete all virtual machines in the scale set.
 | [VirtualMachineScaleSetVM](https://docs.microsoft.com/java/api/com.microsoft.azure.management.compute._virtual_machine_scale_set_v_m) | Retrieved from `virtualMachineScaleSet.virtualMachines().get()` or `list()`, allows you to query, start, stop, configure and delete virtual machines in the scale set.
 | [VirtualMachineScaleSetNetworkInterface](https://docs.microsoft.com/java/api/com.microsoft.azure.management.network._virtual_machine_scale_set_network_interface) | Returned from `virtualMachineScaleSet.listNetworkInterfaces()`, read-only representation of a network interface on a virtual machine in a scale set.
-| [VirtualMachineScaleSetSkuTypes](https://docs.microsoft.com/java/api/com.microsoft.azure.management.compute._virtual_machine_scale_set_sku_types) | Class of static fields used to set the [virtual machine scale set tier](https://azure.microsoft.com/en-us/pricing/details/virtual-machine-scale-sets/linux/) used to define how much resources scale set members can consume.
+| [VirtualMachineScaleSetSkuTypes](https://docs.microsoft.com/java/api/com.microsoft.azure.management.compute._virtual_machine_scale_set_sku_types) | Class of static fields used to set the [virtual machine scale set tier](https://azure.microsoft.com/pricing/details/virtual-machine-scale-sets/linux/) used to define how much resources scale set members can consume.
 | [VirtualMachineScaleSetNicIpConfiguration](https://docs.microsoft.com/java/api/com.microsoft.azure.management.network._virtual_machine_scale_set_nic_i_p_configuration) | Used to query the IP configuration associated with a network interface on a scale set virtual machine.
 
 ## Next steps

docs-ref-conceptual/overview.md

@@ -20,7 +20,7 @@ The Azure libraries for Java let you use Azure services and manage Azure resourc
 
 ## Consume Azure services
 
-Use services such as SQL Database, Azure Storage, Active Directory, and DocumentDB in your Java applications with native APIs. Import the libraries for the services you want to use from [the complete list](java-sdk-azure-install.md) and check out [Java developer center](https://azure.microsoft.com/develop/java/) to learn more about building Java apps with Azure services.
+Use services such as SQL Database, Azure Storage, Active Directory, and DocumentDB in your Java applications with native interfaces. Import the libraries for the services you want to use from [the complete list](java-sdk-azure-install.md) and check out [Java developer center](https://azure.microsoft.com/develop/java/) to learn more about adding features to your apps with Azure services.
 
 Here's some example code to write out the contents of all blobs in an Azure storage container: