Blog

According to their website, “Swagger™ is a specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services.”

What does it mean? Basically, it’s a specification to describe APIs services that keep updated at the same pace as your server code. The benefits are obvious: first of all, you are always providing up to date documentation; also, you are providing an up to date signatures of your services that could be consumed automatically by other services keeping them sync.

The better part of Swagger is that, besides solving the documentation needs, also solves API sandbox needs to play with the exposed services.

If you want to see a live demo of a api documented with Swagger and a sandbox to play with, you can go here.

If you are in Ruby world, there are a couple of gems to handle the Swagger specification for you here.

RailsPanel: "Chrome extension for Rails development that will end your tailing of development.log. Have all information about your Rails app requests in the browser - in the Developer Tools panel. Provides insight to db/rendering/total times, parameter list, rendered views and more.

According the official website, "Discourse is a simple, flat forum, where replies flow down the page in a line. The expandable replies are attached to the bottom and top of each post, so you can discover the fuller context of the conversation - without breaking your flow."

This rough tutorial is a step-by-step guide about the how to setup Discourse aimed to advanced Rails developers who have installed their own Rails apps before. if you are new to Rails, you are likely much better off with this Discourse Vagrant Developer Guide.

This post is heavily based on this document although we have added some comments in bold+italic (missing things in the original file or maybe just due to our machine conf.).

Unit testing as the name implies is about testing individual units of code. Unit tests try to answer questions such as "Did I think about the logic correctly?" or "Does the sort function order the list in the right order?" This is a small, short and ugly step by step of doing unit testing in AngularJS.

We will be setting up a Ruby on Rails development environment on Ubuntu 14.04

The reason we're going to be using Ubuntu is because the majority of code you write will run on a Linux server. Ubuntu is one of the easiest Linux distributions to use with lots of documentation so it's a great one to start with.