Skip to content

Commit 554ce71

Browse files
jack-bergchalin
authored andcommitted
PR feedback
1 parent b4ffd71 commit 554ce71

File tree

1 file changed

+14
-15
lines changed

1 file changed

+14
-15
lines changed

content/en/docs/languages/java/api-components.md

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The API is a set of classes and interfaces for recording telemetry across key
2020
observability signals. The [SDK](../sdk/) is the built-in reference
2121
implementation of the API, [configured](../configuration/) to process and export
2222
telemetry. This page is a conceptual overview of the API, including
23-
descriptions, links to relevant Javadocs, artifact coordinates, sample API
23+
descriptions, links to relevant Javadocs, artifact coordinates, and sample API
2424
usage.
2525

2626
The API consists of the following top-level components:
@@ -79,7 +79,7 @@ It consists of:
7979
propagating `Context` across application boundaries.
8080

8181
The `io.opentelemetry:opentelemetry-extension-kotlint:{{% param vers.otel %}}`
82-
is an extension with tool for propagating context into coroutines.
82+
is an extension with tools for propagating context into coroutines.
8383

8484
### Context
8585

@@ -96,7 +96,7 @@ argument. Context is a recurring concept in the OpenTelemetry API:
9696
[exemplars](/docs/specs/otel/metrics/data-model/#exemplars) and defaulting to
9797
whatever span is currently in context.
9898
- [LogRecords](#logrecordbuilder) accept a context argument, used to link log
99-
records spans and defaulting to whatever span is currently in context.
99+
record spans and defaulting to whatever span is currently in context.
100100

101101
The following code snippet explores `Context` API usage:
102102

@@ -383,8 +383,8 @@ scope:
383383
{{% alert %}} {{% param logBridgeWarning %}} {{% /alert %}}
384384

385385
A scope is identified by the triplet (name, version, schemaUrl). Care must be
386-
taken to ensure to the scope identity is unique. A typical approach is to set
387-
the scope name to the package name or fully qualified class name, and to set the
386+
taken to ensure the scope identity is unique. A typical approach is to set the
387+
scope name to the package name or fully qualified class name, and to set the
388388
scope version to the library version. If emitting telemetry for multiple signals
389389
(i.e. metrics and traces), the same scope should be used. See
390390
[instrumentation scope](/docs/concepts/instrumentation-scope/) for details.
@@ -455,10 +455,9 @@ is a bundle of key value pairs representing the
455455
[standard attribute definition](/docs/specs/otel/common/#standard-attribute).
456456
`Attributes` are a recurring concept in the OpenTelemetry API:
457457

458-
- [Spans](#span), span events, and span links have attributes
459-
- The measurements recorded to [metric instruments](#meter) have attributes
460-
- [LogRecords](#logrecordbuilder) have attributes
461-
- and more
458+
- [Spans](#span), span events, and span links have attributes.
459+
- The measurements recorded to [metric instruments](#meter) have attributes.
460+
- [LogRecords](#logrecordbuilder) have attributes.
462461

463462
See [semantic attributes](#semantic-attributes) for attribute constants
464463
generated from the semantic conventions.
@@ -653,7 +652,7 @@ public class GlobalOpenTelemetryUsage {
653652
### TracerProvider
654653

655654
[TracerProvider](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/io/opentelemetry/api/trace/TracerProvider.html)
656-
is the API entry point for traces, and provides [Tracers](#tracer). See
655+
is the API entry point for traces and provides [Tracers](#tracer). See
657656
[providers and scopes](#providers-and-scopes) for information on providers and
658657
scopes.
659658

@@ -772,13 +771,13 @@ public class SpanUsage {
772771

773772
Span parenting is an important aspect of tracing. Each span has an optional
774773
parent. By collecting all the spans in a trace and following each span's parent,
775-
we can construct a hierarchy. The span APIs are build on top of
774+
we can construct a hierarchy. The span APIs are built on top of
776775
[context](#context), which allows span context to be implicitly passed around an
777776
application and across threads. When a span is created, its parent is set to the
778777
whatever span is present in `Context.current()` unless there is no span or the
779778
context is explicitly overridden.
780779

781-
Most of the context API usage guidance applies to span. Span context is
780+
Most of the context API usage guidance applies to spans. Span context is
782781
propagated across application boundaries with the
783782
[W3CTraceContextPropagator](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/io/opentelemetry/api/trace/propagation/W3CTraceContextPropagator.html)
784783
and other [TextMapPropagators](../sdk/#textmappropagator).
@@ -847,7 +846,7 @@ public class SpanAndContextUsage {
847846
### MeterProvider
848847

849848
[MeterProvider](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/io/opentelemetry/api/metrics/MeterProvider.html)
850-
is the API entry point for metrics, and provides [Meters](#meter). See
849+
is the API entry point for metrics and provides [Meters](#meter). See
851850
[providers and scopes](#providers-and-scopes) for information on providers and
852851
scopes.
853852

@@ -858,7 +857,7 @@ is used to obtain instruments for a particular
858857
[instrumentation scope](#providers-and-scopes). See
859858
[providers and scopes](#providers-and-scopes) for information on providers and
860859
scopes. There are a variety of instruments, each with different semantics and
861-
default behavior in the SDK. Its important to choose the right instrument for
860+
default behavior in the SDK. It's important to choose the right instrument for
862861
each particular use case:
863862

864863
| Instrument | Sync or Async | Description | Example | Default SDK Aggregation |
@@ -1328,7 +1327,7 @@ public class AsyncGaugeUsage {
13281327
### LoggerProvider
13291328

13301329
[LoggerProvider](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/io/opentelemetry/api/logs/LoggerProvider.html)
1331-
is the API entry point for logs, and provides [Loggers](#logger). See
1330+
is the API entry point for logs and provides [Loggers](#logger). See
13321331
[providers and scopes](#providers-and-scopes) for information on providers and
13331332
scopes.
13341333

0 commit comments

Comments
 (0)