Harvester 2.0 should generate api documentation automatically.

[ssebro]

This ticket is to implement automatic swagger doc generation for harvester routes.

module.exports = function (harvester) {

    var category = harvester
        .resource('categories', {
            name: Joi.string().required().description('a name'),
            links: {
                brand: 'brands'
            }
        });
    // Explicit .doc() declaration needed when an override of standard swagger spec is wanted        
    category.getById().doc({summary: 'all the lovely categories by id'})
    .register();
};