diff --git a/akka-zeromq/src/main/scala/akka/zeromq/SocketOption.scala b/akka-zeromq/src/main/scala/akka/zeromq/SocketOption.scala
index 51f92bbbe8..f5c782e849 100644
--- a/akka-zeromq/src/main/scala/akka/zeromq/SocketOption.scala
+++ b/akka-zeromq/src/main/scala/akka/zeromq/SocketOption.scala
@@ -162,14 +162,14 @@ case class PollTimeoutDuration(duration: Duration = 100 millis) extends SocketMe
 case class Bind(endpoint: String) extends SocketConnectOption
 
 /**
- * The [[akka.zeromq.Subscribe]] option shall establish a new message filter on a [[akka.zeromq.SocketType.Pub]] socket.
- * Newly created [[akka.zeromq.SocketType.Sub]] sockets shall filter out all incoming messages,
+ * The [[akka.zeromq.Subscribe]] option establishes a new message filter on a [[akka.zeromq.SocketType.Pub]] socket.
+ * Newly created [[akka.zeromq.SocketType.Sub]] sockets filter out all incoming messages,
  * therefore you should send this option to establish an initial message filter.
  *
- * An empty payload of length zero shall subscribe to all incoming messages.
- * A non-empty payload shall subscribe to all messages beginning with the specified prefix.
+ * An empty payload of length zero will subscribe to all incoming messages.
+ * A non-empty payload will subscribe to all messages beginning with the specified prefix.
  * Multiple filters may be attached to a single [[akka.zeromq.SocketType.Sub]] socket,
- * in which case a message shall be accepted if it matches at least one filter.
+ * in which case a message will be accepted if it matches at least one filter.
  *
  * @param payload the topic to subscribe to
  */