diff --git a/akka-docs/src/main/paradox/guide/modules.md b/akka-docs/src/main/paradox/guide/modules.md
index fb09d4dc85..c380675714 100644
--- a/akka-docs/src/main/paradox/guide/modules.md
+++ b/akka-docs/src/main/paradox/guide/modules.md
@@ -205,7 +205,7 @@ Distributed Data is intended to solve the following challenges:
 Actors are a fundamental model for concurrency, but there are common patterns where their use requires the user
 to implement the same pattern over and over. Very common is the scenario where a chain, or graph, of actors, need to
 process a potentially large, or infinite, stream of sequential events and properly coordinate resource usage so that
-faster operators do not overwhelm slower ones in the chain or graph. Streams provide a higher-level
+faster processing stages do not overwhelm slower ones in the chain or graph. Streams provide a higher-level
 abstraction on top of actors that simplifies writing such processing networks, handling all the fine details in the
 background and providing a safe, typed, composable programming model. Streams is also an implementation
 of the [Reactive Streams standard](http://www.reactive-streams.org) which enables integration with all third
diff --git a/akka-docs/src/main/paradox/stream/stream-customize.md b/akka-docs/src/main/paradox/stream/stream-customize.md
index 1d2d1febf6..22f03a109e 100644
--- a/akka-docs/src/main/paradox/stream/stream-customize.md
+++ b/akka-docs/src/main/paradox/stream/stream-customize.md
@@ -183,8 +183,7 @@ An example of how this API simplifies a stage can be found below in the second v
 
 ### Custom linear operators using GraphStage
 
-GraphStage allows for custom linear processing stages through letting them
-have one input and one output and using `FlowShape` as their shape.
+To define custom linear operators, you should extend `GraphStage` using `FlowShape` which has one input and one output.
 
 Such a stage can be illustrated as a box with two flows as it is
 seen in the illustration below. Demand flowing upstream leading to elements
diff --git a/akka-docs/src/main/paradox/stream/stream-flows-and-basics.md b/akka-docs/src/main/paradox/stream/stream-flows-and-basics.md
index ad721f66e0..44a17e0016 100644
--- a/akka-docs/src/main/paradox/stream/stream-flows-and-basics.md
+++ b/akka-docs/src/main/paradox/stream/stream-flows-and-basics.md
@@ -47,7 +47,7 @@ is running.
 
 Operator
 : The common name for all building blocks that build up a Graph.
-Examples of operators are like `map()`, `filter()`, custom ones extending @ref[`GraphStage`s](stream-customize.md) and graph
+Examples of operators are `map()`, `filter()`, custom ones extending @ref[`GraphStage`s](stream-customize.md) and graph
 junctions like `Merge` or `Broadcast`. For the full list of built-in operators see the @ref:[operator index](operators/index.md)