Once again, this time with the files added

Author: SLsthompson

examples/order_bare_metal_package.rb

@@ -81,7 +81,7 @@ def tl_dr_version
 
   # For this example, we'll assume that we've selected the a package
   # with an id of 32 representing a "Quad Processor, Quad Core Intel"
-  quad_intel_package = SoftLayer::ProductPackage.package_with_id(client, 32)
+  quad_intel_package = SoftLayer::ProductPackage.package_with_id(32, client)
 
   # Now we need to now what ProductItemCategories are required to
   # configure a server in that package. This code prints out a table

examples/ticket_info.rb

@@ -25,24 +25,23 @@
 require 'pp'
 
 softlayer_client = SoftLayer::Client.new(
-  :username => "joecustomer",              # enter your username here
-  :api_key => "feeddeadbeefbadf00d..."     # enter your api key here
+#  :username => "joecustomer",              # enter your username here
+#  :api_key => "feeddeadbeefbadf00d..."     # enter your api key here
   )
 
 begin
+  # Demonstrates using the low-level capabilities of the gem to get
+  # at information.  In this case we are talking directly to the ticket
+  # service
   ticket_service = softlayer_client.service_named("Ticket");
-  ticket_ref = ticket_service.object_with_id(8172109)
+  
+  # Retrive a particular ticket by ID (you will have to substitute an existing ticket's ID here)
+  ticket_ref = ticket_service.object_with_id(12345)
 
-  ticket = ticket_ref.object_mask("mask[updates[entry,createDate],assignedUserId,attachedHardware.datacenter]".getObject
+  # Retrive very specific information about the ticket
+  ticket = ticket_ref.object_mask("mask[updates[entry,createDate],assignedUserId,attachedHardware.datacenter]").getObject
+  
   pp ticket
 rescue Exception => exception
-  puts "Unable to retrieve the ticket"
-end
-
-# update the ticket
-begin
-  updates = ticket_ref.addUpdate({"entry" => "An update from the Ruby client!"})
-  puts "Update ticket 123456. The new update's id is #{updates[0]['id']}"
-rescue Exception => exception
-  puts "Unable to update the ticket: #{exception}"
-end
+  puts "Unable to retrieve the ticket #{exception}"
+end

lib/softlayer/ProductItemCategory.rb

@@ -48,6 +48,17 @@ def free?
   # service.
   class ProductItemCategory < ModelBase
     include ::SoftLayer::DynamicAttribute
+    
+    ##
+    # :attr_reader:
+    # The categoryCode is a primary identifier for a particular
+    # category.  It is a string like 'os' or 'ram'
+    sl_attr :categoryCode
+    
+    ##
+    # :attr_reader:
+    # The name of a category is a friendly, readable string
+    sl_attr :name
 
     sl_dynamic_attr :configuration_options do |config_opts|
       config_opts.should_update? do
@@ -67,7 +78,7 @@ class ProductItemCategory < ModelBase
         #
         # Options are divided into groups (for convenience in the
         # web UI), but this code collapses the groups.
-        groups.collect do |group|
+        self['groups'].collect do |group|
           group['prices'].sort{|lhs,rhs| lhs['sort'] <=> rhs['sort']}.collect do |price_item|
             ProductConfigurationOption.new(
               price_item['id'],

lib/softlayer/ProductPackage.rb

@@ -51,6 +51,10 @@ module SoftLayer
   class ProductPackage < ModelBase
     include ::SoftLayer::DynamicAttribute
 
+    ##
+    # A friendly, readable name for the package
+    sl_attr :name
+
     ##
     # The list of locations where this product package is available.
     sl_attr :availableLocations