Index: vertical_tabs_example.module
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/examples/vertical_tabs_example/vertical_tabs_example.module,v
retrieving revision 1.6
diff -u -r1.6 vertical_tabs_example.module
--- vertical_tabs_example/vertical_tabs_example.module	14 Jan 2011 22:08:07 -0000	1.6
+++ vertical_tabs_example/vertical_tabs_example.module	15 Jan 2011 01:54:42 -0000
@@ -31,24 +31,37 @@
   // Only include on node add/edit forms.
   if (!empty($form['#node_edit_form'])) {
 
+    // Create a custom fieldset that will be included in the vertical tab.
     $form['vertical_tabs_example'] = array(
       '#type' => 'fieldset',
       '#title' => t('Example vertical tab'),
       '#collapsible' => TRUE,
       '#collapsed' => FALSE,
+      '#tree' => TRUE,
+      '#weight' => -2,
       // The #group value must match the name of the vertical tabs element.
-      // In most cases, this is 'additional_settings'.
+      // In most cases, this is 'additional_settings'. This is the only required
+      // form attribute required for the vertical tabs control to include the
+      // form element in the vertical tab group.
       '#group' => 'additional_settings',
-      // Attach the javascript for vertical tabs.
+      // Vertical tabs provide its most usable appearance when they are used to
+      // include a summary of the information contained in the fieldset.
+      // Attaching a javascript for vertical tabs control, in this case it is
+      // used to update the 'summary' property of the vertical tab, which is,
+      // probably the most common usage.
       '#attached' => array(
         'js' => array(
           'vertical-tabs' => drupal_get_path('module', 'vertical_tabs_example') . '/vertical_tabs_example.js',
         ),
       ),
-      '#tree' => TRUE,
-      '#weight' => -2,
     );
 
+    /*
+     * The following form elements are an example of how to capture part of the
+     * fieldset element's information to be displayed in the tab summary when 
+     * the fieldset is collapsed.
+     */
+
     // This checkbox is used to show or hide the custom settings form using
     // javascript (altering states of a container defined later).
     $form['vertical_tabs_example']['enabled'] = array(