Add descriptions and @since comments to all resources

From the docs site

Signed-off-by: Tim Smith <tsmith@chef.io>

1 files changed, 5 insertions, 0 deletions

diff --git a/lib/chef/resource/batch.rb b/lib/chef/resource/batch.rb
index 10e96839fb..b3c7b17cef 100644
--- a/lib/chef/resource/batch.rb
+++ b/lib/chef/resource/batch.rb
@@ -20,6 +20,11 @@ require "chef/resource/windows_script"
 
 class Chef
   class Resource
+    # Use the batch resource to execute a batch script using the cmd.exe interpreter on Windows. The batch resource
+    # creates and executes a temporary file (similar to how the script resource behaves), rather than running the
+    # command inline. Commands that are executed with this resource are (by their nature) not idempotent, as they are
+    # typically unique to the environment in which they are run. Use not_if and only_if to guard this resource for
+    # idempotence.
     class Batch < Chef::Resource::WindowsScript
 
       provides :batch, os: "windows"