From 4e40d75050240d21ac878bc999aadaf8238f1e8b Mon Sep 17 00:00:00 2001
From: Lisa Jamen <31409174+ljamen@users.noreply.github.com>
Date: Thu, 29 Sep 2022 18:51:20 -0400
Subject: [PATCH] updates for PR 4520 language review (#4731)

---
 docs/includes/reactivestreams/engine.adoc      | 4 ++--
 docs/includes/reactivestreams/rsoperators.adoc | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/includes/reactivestreams/engine.adoc b/docs/includes/reactivestreams/engine.adoc
index 9e1d81f2158..1e1253dc270 100644
--- 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]
@@ -137,7 +137,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
index 1f416fd02b6..563780b4436 100644
--- 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 standartized tool for manipulation with https://www.reactive-streams.org/[Reactive Streams]. You can use the Helidon supported reactive operators and tooling when you want to maintain source-level portability between different implementations of the MicroProfile specifications.
 
 
 include::{rootdir}/includes/dependencies.adoc[]
@@ -44,7 +44,7 @@ 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 +106,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 together to close graph with methods
  `via` and `to`.
 
 [source,java]