update docs for attribute_changedlcg/attribute-changed-docs

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

2 files changed, 20 insertions, 29 deletions

diff --git a/DOC_CHANGES.md b/DOC_CHANGES.md
deleted file mode 100644
index fadd382cbb..0000000000
--- a/DOC_CHANGES.md
+++ /dev/null
@@ -1,9 +0,0 @@
-<!---
-This file is reset every time a new release is done. This file describes changes that have not yet been released.
-
-Example Doc Change:
-### Headline for the required change
-Description of the required change.
--->
-
-## Doc changes for Chef 12.13
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: