Tapir & sttp docs

Author: adamw

doc/index.md

@@ -91,6 +91,8 @@ In addition to this documentation, ScalaDocs can be browsed at [https://javadoc.
    integrations/mdc-logback
    integrations/cron4s
    integrations/otel-context
+   integrations/tapir
+   integrations/sttp-client
 
 .. toctree::
    :maxdepth: 2

doc/integrations/sttp-client.md

@@ -0,0 +1,14 @@
+# HTTP client using sttp
+
+[sttp-client](https://sttp.softwaremill.com) is a Scala HTTP client integrating with a number of Scala stacks, 
+including direct-style backends.
+
+The integration is included in the sttp-client library and includes:
+* synchronous backends, which are designed to work with direct-style Scala
+* streaming request & response bodies, converted to/from `Flow`s via `InputStream`s
+* interacting with WebSockets, either using the `WebSocket` interface directly, or using `Flow`s of web socket frames
+* receiving SSE streams as `Flow[ServerSentEvent]`
+
+For more details refer to the sttp-client documentation, specifically:
+* [synchronous backends documentation](https://sttp.softwaremill.com/en/latest/backends/synchronous.html)
+* [usage examples](https://sttp.softwaremill.com/en/latest/examples.html), tagged with the `Direct` label

doc/integrations/tapir.md

@@ -0,0 +1,16 @@
+# HTTP server using Tapir
+
+[Tapir](https://tapir.softwaremill.com) is a library for rapidly developing HTTP APIs. It integrates with a number of 
+Scala stacks, including direct-style server interpreters.
+
+The integration is included in the Tapir library and includes:
+* exposing regular HTTP endpoints (consuming/producing JSON etc.)
+* streaming request & response bodies, converted to/from `Flow`s via `InputStream`s
+* web sockets represented as a transformation between incoming & outgoing `Flow`s of web socket frames
+* SSE response bodies
+
+For more details refer to the Tapir documentation, specifically:
+* the [netty-server-sync interpreter documentation](https://tapir.softwaremill.com/en/latest/server/netty.html)
+* [usage examples](https://tapir.softwaremill.com/en/latest/examples.html), tagged with the `Direct` label
+* [tutorials](https://tapir.softwaremill.com/en/latest/tutorials/01_hello_world.html), which mostly use the 
+  direct-style approach