Skip to content

Commit 77588da

Browse files
author
Brendan Abbott
committed
README/package tweaks
1 parent bf61bc3 commit 77588da

File tree

3 files changed

+19
-8
lines changed

3 files changed

+19
-8
lines changed

.editorconfig

+3-1
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,6 @@ root = true
33
[*]
44
indent_style = space
55
indent_size = 2
6-
insert_final_newline = true
6+
insert_final_newline = true
7+
trim_trailing_whitespace = true
8+
charset = "utf-8"

README.md

+5-7
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
1+
# Serverless OpenAPI Documentation Plugin
12

3+
[![NPM](https://img.shields.io/npm/v/serverless-openapi-documentation.svg)](https://npmjs.org/packages/serverless-openapi-documentation/)
24
[![Travis CI](https://img.shields.io/travis/temando/serverless-openapi-documentation.svg)](https://travis-ci.org/temando/serverless-openapi-documentation)
35
[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
46

5-
6-
# Serverless OpenAPI Documentation Plugin
7-
87
Generates [**OpenAPI 3.0 RC2**](https://github.com/OAI/OpenAPI-Specification/tree/OpenAPI.next) documentation from serverless configuration files. OpenAPI is formerly known as Swagger. The configuration is inspired by the format used in [serverless-aws-documentation](https://www.npmjs.com/package/serverless-aws-documentation).
98

10-
Works well on [Lincoln Open Api Renderer](https://github.com/temando/open-api-renderer)
9+
Works well with [Lincoln Open Api Renderer](https://github.com/temando/open-api-renderer).
1110

1211
---
1312

@@ -170,7 +169,7 @@ functions:
170169
cookieParams:
171170
- name: "SessionId"
172171
description: "A Session ID variable"
173-
schema:
172+
schema:
174173
type: "string"
175174
methodResponses:
176175
- statusCode: 201
@@ -261,7 +260,7 @@ methodResponse:
261260
description: "Content Type header"
262261
schema:
263262
type: "string"
264-
responseModels:
263+
responseModels:
265264
application/json: "CreateResponse"
266265
application/xml: "CreateResponseXML"
267266
```
@@ -334,7 +333,6 @@ serverless | grep "ServerlessOpenAPIDocumentation"
334333

335334
It should return `ServerlessOpenAPIDocumentation` as one of the plugins on the list.
336335

337-
338336
## License
339337

340338
MIT

package.json

+11
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,28 @@
33
"version": "0.2.0",
44
"description": "Serverless 1.0 plugin to generate OpenAPI V3 documentation from serverless configuration",
55
"main": "index.js",
6+
"repository": {
7+
"type": "git",
8+
"url": "https://github.com/temando/serverless-openapi-documentation.git"
9+
},
10+
"bugs": "https://github.com/temando/serverless-openapi-documentation/issues",
611
"author": "Abilio Henrique <[email protected]>",
712
"contributors": [
813
"Abilio Henrique <[email protected]>",
914
1015
],
16+
"keywords":[
17+
"OpenAPI",
18+
"swagger",
19+
"serverless"
20+
],
1121
"license": "MIT",
1222
"scripts": {
1323
"test": "jest",
1424
"test:build": "jest -c '{}' build",
1525
"test:coverage": "jest --coverage",
1626
"lint": "tslint 'src/**/*.ts'",
27+
"preversion": "npm run lint && npm run test",
1728
"release": "cd build && npm publish",
1829
"test:project": "cd test/project && yarn sls openapi generate",
1930
"test:prepare": "scripts/prepareTests.bash",

0 commit comments

Comments
 (0)