transform api member comment to start newlines

this change transforms the api member comments to start a newline
and render multi line comments.

shell.nix

@@ -9,5 +9,6 @@ pkgs.mkShell {
     ghc
     cabal-install
     ghcid
+    ormolu
   ];
 }

src/Tie/Codegen/Operation.hs

@@ -9,6 +9,7 @@ module Tie.Codegen.Operation
 where
 
 import qualified Data.Map.Strict as Map
+import qualified Debug.Trace
 import Prettyprinter (Doc, (<+>))
 import qualified Prettyprinter as PP
 import qualified Prettyprinter.Render.Text as PP
@@ -185,7 +186,18 @@ codegenApiTypeOperation resolver Operation {..} = do
       Nothing ->
         "--" <+> "@" <> toParamName name <> "@" <> PP.line
       Just comment ->
-        "--" <+> "@" <> toParamName name <> "@" <+> PP.pretty comment <> PP.line
+        "--"
+          <+> "@"
+          <> toParamName name
+          <> "@"
+          <> PP.line
+          <> codegenMultilineComment comment
+          <> PP.line
+
+    codegenMultilineComment :: Text -> Doc ann
+    codegenMultilineComment commentLines =
+      let comments = fmap ("-- " <>) $ lines commentLines
+       in PP.cat (fmap PP.pretty comments)
 
     codegenRequestBodyComment RequestBody {description} = case description of
       Nothing ->

test/golden/description.yaml

@@ -0,0 +1,47 @@
+openapi: "3.0.0"
+info:
+  version: 1.0.0
+  title: Scarf
+  license:
+    name: AllRightsReserved
+servers:
+  - url: https://scarf.sh/api/v1
+paths:
+  /test:
+    parameters:
+      - name: package_query
+        in: query
+        required: false
+        description: >
+          Use this query parameter to filter for the packages thats suits your use case.
+          It can be used by passing in either package names or package ids. 
+          To query for multiple packages you can pass in comma separated values.
+          For example:
+
+          ```
+
+          package_query=17ea97c0-d350-45ce-9f36-ebb66694196c,558664cd-fece-47f5-a9ca-f30974cf96a5,...
+
+          ```
+
+          Or if you prefer using package names, you can also pass in 
+
+          ```
+
+          package_query=package_name_1,package_name_2...
+
+          ```
+        schema:
+          type: string
+    get:
+      summary: test
+      operationId: test
+      responses:
+        '200':
+          description: CSV response without schema
+          content:
+            application/json: 
+              schema:
+                description: Undocumented
+                type: array
+components: {}