Agile RESTful API Design

There are two common workflows followed by software engineers developing RESTful API's: the Specification-first approach; and the Implementation-first approach. The Specification-first approach The OpenAPI specification (formerly known as the Swagger specification) is the most popular and widely adopted specification for RESTful APIs. And, there are a great many tools, libraries…

Read More

Annotating JavaScript using JSDoc tags

JSDoc is a markup language used to annotate JavaScript, comments containing JSDoc tags can be used to produce HTML documentation and for declaring the type of a variable. In this post we'll install JSDoc, look at some example markup and then generate some documentation. Note: If you want to follow…

Read More

A JavaScript Microservices stack

Model, Build, Ship, Repeat! Model (Ask & Listen) Business Capabilities & Bounded Contexts Archetypes & Exemplars Getting started with Papyrus Build (Code & Test) Express.js or hapi restify Seneca or koa Private NPM Repository sinopia Service-2-Service Communication dnode is an asynchronous rpc system for Node.js jschan is a…

Read More