README: @HTTPRoute / @JSONRoute

README.md

@@ -290,6 +290,36 @@ protocol WSHandler {
 
 `WSHandler` facilitates the exchange of a pair `AsyncStream<WSFrame>` containing the raw websocket frames sent over the connection. While powerful, it is more convenient to exchange streams of messages via [`WebSocketHTTPHandler`](#websockethttphandler).
 
+## Preview Macro Handler
+
+The branch [`preview/macro`](https://github.com/swhitty/FlyingFox/tree/preview/macro) contains an experimental preview implementation where handlers can annotate its functions with routes:
+
+```swift
+@HTTPHandler
+struct MyHandler {
+
+  @HTTPRoute("/ping")
+  func ping() { }
+
+  @HTTPRoute("/pong")
+  func getPong(_ request: HTTPRequest) -> HTTPResponse {
+    HTTPResponse(statusCode: .accepted)
+  }
+
+  @JSONRoute("POST /account")
+  func createAccount(body: AccountRequest) -> AccountResponse {
+    AccountResponse(id: UUID(), balance: body.balance)
+  }
+}
+
+let server = HTTPServer(port: 80, handler: MyHandler())
+try await server.start()
+```
+
+The annotations are implemented via [SE-0389 Attached Macros](https://github.com/apple/swift-evolution/blob/main/proposals/0389-attached-macros.md) available in Swift 5.9 and later. 
+
+Read more [here](https://github.com/swhitty/FlyingFox/tree/preview/macro#preview-macro-handler).
+
 # FlyingSocks
 
 Internally, FlyingFox uses a thin wrapper around standard BSD sockets. The `FlyingSocks` module provides a cross platform async interface to these sockets;