docs(readme): updated schema comments

Author: kbrandwijk

README.md

@@ -34,24 +34,31 @@ An example for the petstore endpoint can be found [here](./example/petstore.json
 This endpoint definition is transformed into a GraphQL schema, with all the paths from the endpoint translated into queries and mutations. This schema looks like this:
 ```graphql
 type Query {
-  """ GET /pet/findPetsByStatus """
+  # GET /pet/findPetsByStatus
   findPetsByStatus(status: [String]): [findPetsByStatus_items]
-  """ GET /pet/findPetsByTags """
+
+  # GET /pet/findPetsByTags
   findPetsByTags(tags: [String]): [findPetsByTags_items]
-  """ GET /pet/{petId} """
+
+  # GET /pet/{petId}
   getPetById(petId: String): getPetById
+
   # other queries
 }
 
 type Mutation {
-  """ POST /pet """
+  # POST /pet
   addPet(body: param_addPet_body): addPet
-  """ PUT /pet """
+  
+  # PUT /pet
   updatePet(body: param_updatePet_body): updatePet
-  """ PUT /pet/{petId} """
+  
+  # PUT /pet/{petId}
   updatePetWithForm(petId: String, name: String, status: String): updatePetWithForm
-  """ DELETE /pet/{petId} """
+  
+  # DELETE /pet/{petId}
   deletePet(api_key: String, petId: String): deletePet
+  
   # other mutations
 }
 ```