update docs for attribute_changedlcg/attribute-changed-docs

Signed-off-by: Lamont Granquist <lamont@scriptkiddie.org>

1 files changed, 20 insertions, 20 deletions

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 39842b7a5e..1e1920b600 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -1,35 +1,35 @@
 *This file holds "in progress" release notes for the current release under development and is intended for consumption by the Chef Documentation team.
 Please see [https://docs.chef.io/release_notes.html](https://docs.chef.io/release_notes.html) for the official Chef release notes.*
 
-# Chef Client Release Notes 12.15:
+# Chef Client Release Notes 12.16:
 
 ## Highlighted enhancements for this release:
 
-* Omnibus packages are now available for Ubuntu 16.04.
+* Added `attribute_changed` event hook:
 
-* Added cab_package resource and provider which supports the installation of CAB/cabinet packages on Windows. Example:
+In a cookbook library file, you can add this in order to print out all attribute changes in cookbooks:
 
-  ```ruby
-  cab_package 'Install .NET 3.5 sp1 via KB958488' do
-    source 'C:\Users\xyz\AppData\Local\Temp\Windows6.1-KB958488-x64.cab'
-    action :install
+```ruby
+Chef.event_handler do
+  on :attribute_changed do |precedence, key, value|
+    puts "setting attribute #{precedence}#{key.map {|n| "[\"#{n}\"]" }.join} = #{value}"
   end
+end
+```
 
-  cab_package 'Remove .NET 3.5 sp1 via KB958488' do
-    source 'C:\Users\xyz\AppData\Local\Temp\Windows6.1-KB958488-x64.cab'
-    action :remove
-  end
-  ```
-  **NOTE:** cab_package resource does not support URLs in `source`.
-
-* Added exit code 213 (Chef Upgrades) from [RFC062](https://github.com/chef/chef-rfc/blob/master/rfc062-exit-status.md)
-  * This allows for easier testing of chef client upgrades in Test Kitchen. See [omnibus_updater](https://github.com/chef-cookbooks/omnibus_updater)
+If you want to setup a policy that override attributes should never be used:
 
-* Set `yum_repository` gpgcheck default to true.
-
-* Allow deletion of `registry_key` without the need for users to pass data key in values hash.
+```ruby
+Chef.event_handler do
+  on :attribute_changed do |precedence, key, value|
+    raise "override policy violation" if precedence == :override
+  end
+end
+```
 
-* `knife ssh` will pass the -P option on the command line, if it is given, as the sudo password and will bypass prompting.
+There will likely be some missed attribute changes and some bugs that need fixing (hint: PRs accepted), there could be
+added command line options to print out all attribute changes or filter them (hint: PRs accepted), or to add source
+file and line numbers to the event (hint: PRs accepted).
 
 ## Highlighted bug fixes for this release: