Update README.md

README.md

@@ -48,20 +48,28 @@ var cookieParser = require('cookie-parser');
 var bodyParser = require('body-parser');
 var logger = require('morgan');
 var http = require('http');
-var OpenApiValidator = require('express-openapi-validator').OpenApiValidator;
 var app = express();
 
+// 1. Import the express-openapi-validator library
+var OpenApiValidator = require('express-openapi-validator').OpenApiValidator;
+
 app.use(bodyParser.json());
 app.use(logger('dev'));
 app.use(express.json());
 app.use(express.urlencoded({ extended: false }));
 app.use(cookieParser());
 app.use(express.static(path.join(__dirname, 'public')));
 
+// 2. (optionally) Serve the OpenAPI spec
+const spec = path.join(__dirname, 'openapi.yaml');
+app.use('/spec', express.static(spec));
+
+// 3. Install the OpenApiValidator onto your express app
 new OpenApiValidator({
   apiSpecPath: './openapi.yaml',
 }).install(app);
 
+// 4. Define routes using Express
 app.get('/v1/pets', function(req, res, next) {
   res.json([{ id: 1, name: 'max' }, { id: 2, name: 'mini' }]);
 });
@@ -74,19 +82,13 @@ app.get('/v1/pets/:id', function(req, res, next) {
   res.json({ id: req.params.id, name: 'sparky' });
 });
 
-// Register error handler
+// 5. Create an Express error handler
 app.use((err, req, res, next) => {
-  // format error
+  // 6. Customize errors
   res.status(err.status).json({
     errors: err.errors,
   });
 });
-
-var server = http.createServer(app);
-server.listen(3000);
-console.log('Listening on port 3000');
-
-module.exports = app;
 ```
 
 ## [Example Express API Server](https://github.com/cdimascio/express-openapi-validator-example) (clone it)