refactor(instance): .save(fields, options) -> .save(options)

docs/docs/instances.md

@@ -92,12 +92,12 @@ It's also possible to define which attributes should be saved when calling`save`
 ```js
 task.title = 'foooo'
 task.description = 'baaaaaar'
-task.save(['title']).success(function() {
+task.save({fields: ['title']}).then(function() {
  // title will now be 'foooo' but description is the very same as before
 })
  
 // The equivalent call using updateAttributes looks like this:
-task.updateAttributes({ title: 'foooo', description: 'baaaaaar'}, ['title']).success(function() {
+task.updateAttributes({ title: 'foooo', description: 'baaaaaar'}, {fields: ['title']}).success(function() {
  // title will now be 'foooo' but description is the very same as before
 })
 ```

lib/instance.js

@@ -442,22 +442,21 @@ module.exports = (function() {
    * On success, the callback will be called with this instance. On validation error, the callback will be called with an instance of `Sequelize.ValidationError`.
    * This error will have a property for each of the fields for which validation failed, with the error message for that field.
    *
-   * @param {Array} [fields] An optional array of strings, representing database columns. If fields is provided, only those columns will be validation and saved.
    * @param {Object} [options]
-   * @param {Object} [options.fields] An alternative way of setting which fields should be persisted
+   * @param {Object} [options.fields] An optional array of strings, representing database columns. If fields is provided, only those columns will be validation and saved.
    * @param {Boolean} [options.silent=false] If true, the updatedAt timestamp will not be updated.
    * @param {Transaction} [options.transaction]
    *
    * @return {Promise<this|Errors.ValidationError>}
    */
-  Instance.prototype.save = function(fieldsOrOptions, options) {
-    if (fieldsOrOptions instanceof Array) {
-      fieldsOrOptions = { fields: fieldsOrOptions };
+  Instance.prototype.save = function(options, deprecated) {
+    if (options instanceof Array) {
+      options = { fields: options };
     }
 
     options = Utils._.extend({
       hooks: true
-    }, options, fieldsOrOptions);
+    }, options, deprecated);
 
     if (!options.fields) {
       options.fields = Object.keys(this.Model.attributes);