Add RELEASE_NOTES for #3318

1 files changed, 36 insertions, 0 deletions

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 5387870856..cc59716ff9 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -33,3 +33,39 @@ remote_file 'C:\Foo.tar.gz' do
   source "\\\\foohost\\fooshare\\Foo.tar.gz"
 end
 ```
+
+## WindowsPackage resource supports URLs
+
+The `windows_package` resource now allows specifying URLs for the source
+attribute. For example, you could install 7zip with the following resource:
+
+```ruby
+windows_package '7zip' do
+  source "http://www.7-zip.org/a/7z938-x64.msi"
+end
+```
+
+Internally, this is done by using a `remote_file` resource to download the
+contents at the specified url. If needed, you can modify the attributes of
+the `remote_file` resource using the `remote_file_attributes` attribute. 
+The `remote_file_attributes` accepts a hash of attributes that will be set
+on the underlying remote_file. For example, the checksum of the contents can 
+be verified using
+
+```ruby
+windows_package '7zip' do
+  source "http://www.7-zip.org/a/7z938-x64.msi"
+  remote_file_attributes :checksum => '7c8e873991c82ad9cfcdbdf45254ea6101e9a645e12977dcd518979e50fdedf3'
+end
+```
+
+To make the transition easier from the Windows cookbook, `windows_package` also 
+accepts the `checksum` attribute, and the previous resource could be rewritten
+as:
+
+```ruby
+windows_package '7zip' do
+  source "http://www.7-zip.org/a/7z938-x64.msi"
+  checksum '7c8e873991c82ad9cfcdbdf45254ea6101e9a645e12977dcd518979e50fdedf3'
+end
+```