Maybe a problem with the note section for array call of package resource

On line 498 of the package resource there's this note line:

.. note:: Notifications and subscriptions do not need to be updated when packages and versions are added or removed from the package_name or version properties.

I think it's half true, and could maybe be reworded as:

`.. note:: Notifications and subscriptions do not need to be updated when pacakges versions are updated in the version properties but must be updated if the list of packages changes.

Or keeping the note as is thenthe exemple above should be

package 'my_stack'  do
    package_name %w(package1 package2)
    version [ '1.3.4-2', '4.3.6-1']                  
    action :nothing
 end

log 'call a notification' do
     notifies :install, 'package[my_stack]', :immediately
end

Open chef_master/source/resource_package.rst around line 498 and compare the note with the package resource example immediately around it. Check whether notifications and subscriptions behave differently when package names versus versions change, then update the note or example so they agree and correct the wording.