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