Skip to content

[bulk] Validation: Metadata and Absolute Links #2283

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
May 2, 2022
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 17 additions & 18 deletions docs-ref-services/preview/cosmos-readme.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,13 @@
---
title: Azure CosmosDB Client Library for Java
description: Learn how to use Azure CosmosDB client library, a multi-model database service for operational and analytics workloads.
keywords: Azure, java, SDK, API, azure-cosmos, cosmosdb
author: moderakh
ms.author: moderakh
ms.author: kuthapar
ms.date: 01/26/2022
ms.topic: reference
ms.prod: azure
ms.technology: azure
ms.devlang: java
ms.service: cosmosdb
ms.service: cosmos-db
---
# Azure CosmosDB Client Library for Java - Version 4.26.0-beta.1

Expand Down Expand Up @@ -70,7 +69,7 @@ Refer to [javadocs][api_documentation] for more details on the package
### Prerequisites

- [Java Development Kit (JDK) with version 8 or above][jdk]
- An active Azure account. If you don't have one, you can sign up for a [free account][azure_subscription]. Alternatively, you can use the [Azure Cosmos DB Emulator](https://azure.microsoft.com/documentation/articles/documentdb-nosql-local-emulator) for development and testing. As emulator https certificate is self signed, you need to import its certificate to java trusted cert store as [explained here](https://docs.microsoft.com/azure/cosmos-db/local-emulator-export-ssl-certificates)
- An active Azure account. If you don't have one, you can sign up for a [free account][azure_subscription]. Alternatively, you can use the [Azure Cosmos DB Emulator](https://azure.microsoft.com/documentation/articles/documentdb-nosql-local-emulator) for development and testing. As emulator https certificate is self signed, you need to import its certificate to java trusted cert store as [explained here](/azure/cosmos-db/local-emulator-export-ssl-certificates)
- (Optional) SLF4J is a logging facade.
- (Optional) [SLF4J binding](https://www.slf4j.org/manual.html) is used to associate a specific logging framework with SLF4J.
- (Optional) [Maven][maven]
Expand Down Expand Up @@ -107,32 +106,32 @@ CosmosClient cosmosClient = new CosmosClientBuilder()

Azure Cosmos DB Java SDK provides client-side logical representation to access the Azure Cosmos DB SQL API.
A Cosmos DB account contains zero or more databases, a database (DB) contains zero or more containers, and a container contains zero or more items.
You may read more about databases, containers and items [here](https://docs.microsoft.com/azure/cosmos-db/databases-containers-items).
You may read more about databases, containers and items [here](/azure/cosmos-db/databases-containers-items).
A few important properties defined at the level of the container, among them are provisioned throughput and partition key.

### Global Distribution
- Azure Cosmos DB is a globally distributed database service that's designed to provide low latency, elastic scalability of throughput, well-defined semantics for data consistency, and high availability.
In short, if your application needs guaranteed fast response time anywhere in the world, if it's required to be always online, and needs unlimited and elastic scalability of throughput and storage, you should build your application on Azure Cosmos DB.
You may read more about global distribution [here](https://docs.microsoft.com/azure/cosmos-db/distribute-data-globally).
You may read more about global distribution [here](/azure/cosmos-db/distribute-data-globally).

### Throughput Provisioning
- Azure Cosmos DB allows you to set provisioned throughput on your databases and containers.
There are two types of provisioned throughput, standard (manual) or autoscale. Provisioned throughput can be selected at per-container granularity or per-database granularity, however container-level throughput specification is typically preferred.
You may read more about throughput provisioning [here](https://docs.microsoft.com/azure/cosmos-db/set-throughput).
You may read more about throughput provisioning [here](/azure/cosmos-db/set-throughput).

### Request Units (RUs)
- Azure Cosmos DB supports many APIs, such as SQL, MongoDB, Cassandra, Gremlin, and Table.
Each API has its own set of database operations. These operations range from simple point reads and writes to complex queries.
Each database operation consumes system resources based on the complexity of the operation. The cost of all database operations is normalized by Azure Cosmos DB and is expressed by Request Units (or RUs, for short).
You can think of RUs per second as the currency for throughput. RUs per second is a rate-based currency. It abstracts the system resources such as CPU, IOPS, and memory that are required to perform the database operations supported by Azure Cosmos DB.
You may read more about request units [here](https://docs.microsoft.com/azure/cosmos-db/request-units).
You may read more about request units [here](/azure/cosmos-db/request-units).

### Partitioning
- As items are inserted into a Cosmos DB container, the database grows horizontally by adding more storage and compute to handle requests.
Storage and compute capacity are added in discrete units known as partitions, and you must choose one field in your documents to be the partition key which maps each document to a partition.
The way partitions are managed is that each partition is assigned a roughly equal slice out of the range of partition key values; therefore you are advised to choose a partition key which is relatively random or evenly-distributed.
Otherwise, some partitions will see substantially more requests (hot partition) while other partitions see substantially fewer requests (cold partition), and this is to be avoided.
You may learn more about partitioning [here](https://docs.microsoft.com/azure/cosmos-db/partitioning-overview).
You may learn more about partitioning [here](/azure/cosmos-db/partitioning-overview).

## Examples

Expand Down Expand Up @@ -300,26 +299,26 @@ or contact [[email protected]][coc_contact] with any additional questions o

<!-- LINKS -->
[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-cosmos_4.26.0-beta.1/sdk/cosmos/azure-cosmos/src
[cosmos_introduction]: https://docs.microsoft.com/azure/cosmos-db/
[cosmos_introduction]: /azure/cosmos-db/
[api_documentation]: https://azuresdkdocs.blob.core.windows.net/$web/java/azure-cosmos/latest/index.html
[cosmos_docs]: https://docs.microsoft.com/azure/cosmos-db/introduction
[jdk]: https://docs.microsoft.com/java/azure/jdk/
[cosmos_docs]: /azure/cosmos-db/introduction
[jdk]: /java/azure/jdk/
[slf4j]: http://www.slf4j.org/
[maven]: https://maven.apache.org/
[cosmos_maven]: https://search.maven.org/artifact/com.azure/azure-cosmos
[cosmos_maven_svg]: https://img.shields.io/maven-central/v/com.azure/azure-cosmos.svg
[cla]: https://cla.microsoft.com
[coc]: https://opensource.microsoft.com/codeofconduct/
[coc]: /codeofconduct/
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
[coc_contact]: mailto:[email protected]
[azure_subscription]: https://azure.microsoft.com/free/
[samples]: https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples
[samples_readme]: https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/master/README.md
[troubleshooting]: https://docs.microsoft.com/azure/cosmos-db/troubleshoot-java-sdk-v4-sql
[perf_guide]: https://docs.microsoft.com/azure/cosmos-db/performance-tips-java-sdk-v4-sql?tabs=api-async
[sql_api_query]: https://docs.microsoft.com/azure/cosmos-db/sql-api-sql-query
[troubleshooting]: /azure/cosmos-db/troubleshoot-java-sdk-v4-sql
[perf_guide]: /azure/cosmos-db/performance-tips-java-sdk-v4-sql?tabs=api-async
[sql_api_query]: /azure/cosmos-db/sql-api-sql-query
[getting_started]: https://github.com/Azure-Samples/azure-cosmos-java-getting-started
[quickstart]: https://docs.microsoft.com/azure/cosmos-db/create-sql-api-java?tabs=sync
[quickstart]: /azure/cosmos-db/create-sql-api-java?tabs=sync
[project_reactor_schedulers]: https://projectreactor.io/docs/core/release/api/reactor/core/scheduler/Schedulers.html

![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcosmos%2Fazure-cosmos%2FREADME.png)
Expand Down
28 changes: 16 additions & 12 deletions docs-ref-services/preview/data-appconfiguration-readme.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,15 @@
---
title: Azure App Configuration client library for Java
description: Learn how to centralize your application configurations simply and securely using Azure App Configuration.
keywords: Azure, java, SDK, API, azure-data-appconfiguration, appconfiguration
author: ramya-rao-a
ms.author: ramyar
ms.author: shafang
ms.date: 04/09/2021
ms.topic: reference
ms.prod: azure
ms.technology: azure


ms.devlang: java
ms.service: appconfiguration
ms.service: azure-app-configuration
---

# Azure App Configuration client library for Java - Version 1.2.0-beta.1
Expand All @@ -19,8 +20,11 @@ Modern programs, especially programs running in a cloud, generally have many com

Use the client library for App Configuration to create and manage application configuration settings.

[Source code][source_code] | [Package (Maven)][package] | [API reference documentation][api_documentation]
| [Product documentation][azconfig_docs] | [Samples][samples]
- [Source code][source_code]
- [Package (Maven)][package]
- [API reference documentation][api_documentation]
- [Product documentation][azconfig_docs]
- [Samples][samples]

## Getting started

Expand Down Expand Up @@ -418,25 +422,25 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m
<!-- LINKS -->
[add_headers_from_context_policy]: https://github.com/Azure/azure-sdk-for-java/blob/azure-data-appconfiguration_1.2.0-beta.1/sdk/core/azure-core/src/main/java/com/azure/core/http/policy/AddHeadersFromContextPolicy.java
[api_documentation]: https://aka.ms/java-docs
[app_config_store]: https://docs.microsoft.com/azure/azure-app-configuration/quickstart-dotnet-core-app#create-an-app-configuration-store
[app_config_role]: https://docs.microsoft.com/azure/azure-app-configuration/rest-api-authorization-azure-ad#roles
[azconfig_docs]: https://docs.microsoft.com/azure/azure-app-configuration
[azure_cli]: https://docs.microsoft.com/cli/azure
[app_config_store]: /azure/azure-app-configuration/quickstart-dotnet-core-app#create-an-app-configuration-store
[app_config_role]: /azure/azure-app-configuration/rest-api-authorization-azure-ad#roles
[azconfig_docs]: /azure/azure-app-configuration
[azure_cli]: /cli/azure
[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-data-appconfiguration_1.2.0-beta.1/sdk/identity/azure-identity
[azure_subscription]: https://azure.microsoft.com/free
[cla]: https://cla.microsoft.com
[coc]: https://opensource.microsoft.com/codeofconduct/
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
[coc_contact]: mailto:[email protected]
[default_cred_ref]: https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.0.1/com/azure/identity/DefaultAzureCredential.html
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[jdk_link]: /java/azure/jdk/
[maven]: https://maven.apache.org/
[package]: https://search.maven.org/artifact/com.azure/azure-data-appconfiguration
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
[rest_api]: https://github.com/Azure/AppConfiguration#rest-api-reference
[samples]: https://github.com/Azure/azure-sdk-for-java/blob/azure-data-appconfiguration_1.2.0-beta.1/sdk/appconfiguration/azure-data-appconfiguration/src/samples/java/com/azure/data/appconfiguration
[samples_readme]: https://github.com/Azure/azure-sdk-for-java/blob/azure-data-appconfiguration_1.2.0-beta.1/sdk/appconfiguration/azure-data-appconfiguration/src/samples/README.md
[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-data-appconfiguration_1.2.0-beta.1/sdk/appconfiguration/azure-data-appconfiguration/src
[spring_quickstart]: https://docs.microsoft.com/azure/azure-app-configuration/quickstart-java-spring-app
[spring_quickstart]: /azure/azure-app-configuration/quickstart-java-spring-app
![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fappconfiguration%2Fazure-data-appconfiguration%2FREADME.png)