From 0d4e6b72cd7955f401545c673b79fef111e98739 Mon Sep 17 00:00:00 2001
From: Alexander Sysoev <Alexander.Sysoev@jetbrains.com>
Date: Mon, 14 Jul 2025 15:03:45 +0200
Subject: [PATCH] Docs for gRPC with Ktor #393

---
 docs/pages/kotlinx-rpc/rpc.tree               |  1 +
 .../kotlinx-rpc/topics/grpc-client.topic      |  8 +++--
 .../kotlinx-rpc/topics/grpc-ktor-server.topic | 31 +++++++++++++++++++
 3 files changed, 38 insertions(+), 2 deletions(-)
 create mode 100644 docs/pages/kotlinx-rpc/topics/grpc-ktor-server.topic

diff --git a/docs/pages/kotlinx-rpc/rpc.tree b/docs/pages/kotlinx-rpc/rpc.tree
index 7ae8df4a2..8f1c1fde5 100644
--- a/docs/pages/kotlinx-rpc/rpc.tree
+++ b/docs/pages/kotlinx-rpc/rpc.tree
@@ -35,6 +35,7 @@
             <toc-element topic="grpc-services.topic"/>
             <toc-element topic="grpc-client.topic"/>
             <toc-element topic="grpc-server.topic"/>
+            <toc-element topic="grpc-ktor-server.topic"/>
         </toc-element>
     </toc-element>
     <toc-element topic="strict-mode.topic"/>
diff --git a/docs/pages/kotlinx-rpc/topics/grpc-client.topic b/docs/pages/kotlinx-rpc/topics/grpc-client.topic
index 58cdc6676..becca5e4c 100644
--- a/docs/pages/kotlinx-rpc/topics/grpc-client.topic
+++ b/docs/pages/kotlinx-rpc/topics/grpc-client.topic
@@ -1,4 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  - Copyright 2023-2025 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
+  -->
+
 <!DOCTYPE topic
         SYSTEM "https://resources.jetbrains.com/writerside/1.0/xhtml-entities.dtd">
 <topic xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -21,11 +25,11 @@
         val result = recognizer.recognize(image)
         println("Recognized category: ${result.category}")
 
-        grpcClient.cancel()
+        grpcClient.close()
     </code-block>
     <list>
         <li>
             <code>usePlaintext()</code> - is a JVM binding to Java gRPC runtime. Other bindings are also present.
         </li>
     </list>
-</topic>
\ No newline at end of file
+</topic>
diff --git a/docs/pages/kotlinx-rpc/topics/grpc-ktor-server.topic b/docs/pages/kotlinx-rpc/topics/grpc-ktor-server.topic
new file mode 100644
index 000000000..dc9bb0e2e
--- /dev/null
+++ b/docs/pages/kotlinx-rpc/topics/grpc-ktor-server.topic
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  - Copyright 2023-2025 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
+  -->
+
+<!DOCTYPE topic
+        SYSTEM "https://resources.jetbrains.com/writerside/1.0/xhtml-entities.dtd">
+<topic xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/topic.v2.xsd"
+       title="Ktor Server" id="grpc-ktor-server">
+
+    <p>
+        Similarly to <a href="grpc-server.topic"/>,
+        you can use gRPC with Ktor:
+    </p>
+    <code-block lang="kotlin">
+fun Application.module() {
+    grpc(port = PORT, configure = { /* ... */ }) {
+        registerService&lt;MyService&gt; { MyServiceImpl() }
+    }
+}
+    </code-block>
+    <p>
+        <code>GrpcServer</code> instance is created and bound to the Ktor Application lifetime.
+        It can be accessed via <code>application.attributes[GrpcServerKey]</code>.
+    </p>
+    Add the Ktor dependency to your project:
+    <code-block lang="kotlin">
+        implementation("org.jetbrains.kotlinx:kotlinx-rpc-grpc-ktor-server:%kotlinx-rpc-version%")
+    </code-block>
+</topic>