1 files changed, 27 insertions, 0 deletions
diff --git a/activejob/CHANGELOG.md b/activejob/CHANGELOG.md
new file mode 100644
index 0000000000..afdd42be33
--- /dev/null
+++ b/activejob/CHANGELOG.md
@@ -0,0 +1,27 @@
+*  `ActiveJob::Base.deserialize` delegates to the job class
+
+
+    Since `ActiveJob::Base#deserialize` can be overridden by subclasses (like
+    `ActiveJob::Base#serialize`) this allows jobs to attach arbitrary metadata
+    when they get serialized and read it back when they get performed. Example:
+
+      class DeliverWebhookJob < ActiveJob::Base
+        def serialize
+          super.merge('attempt_number' => (@attempt_number || 0) + 1)
+        end
+
+        def deserialize(job_data)
+          super
+          @attempt_number = job_data['attempt_number']
+        end
+
+        rescue_from(TimeoutError) do |exception|
+          raise exception if @attempt_number > 5
+          retry_job(wait: 10)
+        end
+      end
+
+    *Isaac Seymour*
+
+
+Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-stable/activejob/CHANGELOG.md) for previous changes.