README documentantion complement

README.md

@@ -146,6 +146,55 @@ models:
           type: String    
 ```
 
+## Read from jsdoc
+
+Example 'api.coffee'
+
+```coffee
+
+###
+ * @swagger
+ * resourcePath: /api
+ * description: All about API
+###
+
+###
+ * @swagger
+ * path: /login
+ * operations:
+ *   -  httpMethod: POST
+ *      summary: Login with username and password
+ *      notes: Returns a user based on username
+ *      responseClass: User
+ *      nickname: login
+ *      consumes:
+ *        - text/html
+ *      parameters:
+ *        - name: username
+ *          description: Your username
+ *          paramType: query
+ *          required: true
+ *          dataType: string
+ *        - name: password
+ *          description: Your password
+ *          paramType: query
+ *          required: true
+ *          dataType: string
+###
+
+###
+ * @swagger
+ * models:
+ *   User:
+ *     id: User
+ *     properties:
+ *       username:
+ *         type: String
+ *       password:
+ *         type: String
+###
+```
+
 
 ## Examples