Adds example to Source.completionStageSource (#28639)

akka-docs/src/test/java/jdocs/stream/operators/source/CompletionStageSource.java

@@ -0,0 +1,28 @@
+/*
+ * Copyright (C) 2020 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package jdocs.stream.operators.source;
+
+// #sourceCompletionStageSource
+import akka.NotUsed;
+import akka.stream.javadsl.Source;
+
+import java.util.concurrent.CompletionStage;
+
+public class CompletionStageSource {
+
+  public static void sourceCompletionStageSource() {
+    UserRepository userRepository = null; // an abstraction over the remote service
+    Source<User, CompletionStage<NotUsed>> userCompletionStageSource =
+        Source.completionStageSource(userRepository.loadUsers());
+    // ...
+  }
+
+  interface UserRepository {
+    CompletionStage<Source<User, NotUsed>> loadUsers();
+  }
+
+  static class User {}
+}
+// #sourceCompletionStageSource

akka-docs/src/test/scala/docs/stream/operators/source/FutureSource.scala

@@ -0,0 +1,28 @@
+/*
+ * Copyright (C) 2020 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package docs.stream.operators.source
+
+// #sourceFutureSource
+
+import akka.NotUsed
+import akka.stream.scaladsl.Source
+
+import scala.concurrent.Future
+
+object FutureSource {
+  def sourceCompletionStageSource(): Unit = {
+    val userRepository: UserRepository = ??? // an abstraction over the remote service
+    val userFutureSource = Source.futureSource(userRepository.loadUsers)
+    // ...
+  }
+
+  trait UserRepository {
+    def loadUsers: Future[Source[User, NotUsed]]
+  }
+
+  case class User()
+}
+
+// #sourceFutureSource