Reactive streams doc alignment helidon-io#6458

danielkec · Oct 5, 2023 · de4c253 · de4c253
1 parent bf22456
commit de4c253
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 5 deletions.
diff --git a/docs/includes/reactivestreams/engine.adoc b/docs/includes/reactivestreams/engine.adoc
@@ -45,7 +45,7 @@ include::{rootdir}/includes/dependencies.adoc[]
 
 == Usage
 
-Stream processing operator chain can be easily constructed by `io.helidon.common.reactive.Multi`, or
+The stream processing operator chain can be easily constructed by `io.helidon.common.reactive.Multi`, or
 `io.helidon.common.reactive.Single` for streams with single value.
 
 [source,java]
@@ -138,7 +138,7 @@ Single.just("1")
 
 |===
 
-=== Operator chains composition
+=== Operator Chains Composition
 
 In the situations when part of the operator chain needs to be prepared in advance,
 `compose` and `to` operators are at hand.

diff --git a/docs/includes/reactivestreams/rsoperators.adoc b/docs/includes/reactivestreams/rsoperators.adoc
@@ -29,7 +29,7 @@ ifndef::rootdir[:rootdir: {docdir}/../..]
 
 == Overview
 
-Helidon implements link:{microprofile-rs-operators-spec-url}[MicroProfile Reactive Streams Operators] specification which defines reactive operators and provides a standartized tool for manipulation with https://www.reactive-streams.org/[Reactive Streams]. Use it you want stick with MicroProfile ecosystem which guarantees source-level portability between different implementations of the specification.
+Helidon implements link:{microprofile-rs-operators-spec-url}[MicroProfile Reactive Streams Operators] specification which defines reactive operators and provides a standardized tool for manipulation with https://www.reactive-streams.org/[Reactive Streams]. You can use MicroProfile Reactive Streams Operators when you want to maintain source-level portability between different implementations.
 
 
 include::{rootdir}/includes/dependencies.adoc[]
@@ -44,7 +44,8 @@ include::{rootdir}/includes/dependencies.adoc[]
 
 == Usage
 
-The specification provides a set of operators as so called stages, and the builders to prepare graphs of stages for streams to be build from.
+The MicroProfile Reactive Streams Operators specification provides a set of operators within stages,
+as well as the builders used to prepare graphs of stages from which streams can be built.
 
 [source,java]
 .Example of simple closed graph usage:
@@ -106,7 +107,7 @@ ReactiveStreams.of("1", "2", "3", "4", "5")
 === Graphs
 
 link:{microprofile-rs-operators-spec-url}#_graphs[Graphs] are pre-prepared stream builders with
- link:{microprofile-rs-operators-spec-url}#_stages[stages], which can be combined together to closed graph with methods
+ link:{microprofile-rs-operators-spec-url}#_stages[stages], which can be combined to closed graph with methods
  `via` and `to`.
 
 [source,java]