[DOC] web: add documentation on notification system

Also, fix a few errors in the js docstring

addons/web/static/src/js/services/notification_service.js

@@ -71,12 +71,12 @@ var NotificationService = AbstractService.extend({
      * @param {string} [params.buttons[0].icon] font-awsome className or image src
      * @returns {Number} notification id
      */
-    notify: function (options) {
+    notify: function (params) {
         if (!this.$el) {
             this.$el = $('<div class="o_notification_manager"/>');
             this.$el.prependTo('body');
         }
-        var notification = this.notifications[++id] = new Notification(this, options);
+        var notification = this.notifications[++id] = new Notification(this, params);
         notification.appendTo(this.$el);
         return id;
     },

addons/web/static/src/js/views/basic/basic_model.js

@@ -948,7 +948,7 @@ var BasicModel = AbstractModel.extend({
      * - call the /create or /write method according to the record status
      * - After that, it has to reload all data, in case something changed, server side.
      *
-     * @param {string} record_id local resource
+     * @param {string} recordID local resource
      * @param {Object} [options]
      * @param {boolean} [options.reload=true] if true, data will be reloaded
      * @param {boolean} [options.savePoint=false] if true, the record will only