add comments to volumes models and resource, fix test, fix jshint