diff --git a/lib/OpenLayers/Feature/Vector.js b/lib/OpenLayers/Feature/Vector.js
index 2621b8c3b0..a7576a8410 100644
--- a/lib/OpenLayers/Feature/Vector.js
+++ b/lib/OpenLayers/Feature/Vector.js
@@ -35,14 +35,15 @@ OpenLayers.Feature.Vector.prototype =
     fid: null,
     
     /** 
-     * Property: geometry 
+     * APIProperty: geometry 
      * {<OpenLayers.Geometry>} 
      */
     geometry: null,
 
     /** 
-     * Property: attributes 
-     * {Object} 
+     * APIProperty: attributes 
+     * {Object} This object holds arbitrary properties that describe the
+     *     feature.
      */
     attributes: null,
 
@@ -53,7 +54,7 @@ OpenLayers.Feature.Vector.prototype =
     state: null,
     
     /** 
-     * Property: style 
+     * APIProperty: style 
      * {Object} 
      */
     style: null,
@@ -63,9 +64,10 @@ OpenLayers.Feature.Vector.prototype =
      * Create a vector feature. 
      * 
      * Parameters:
-     * geometry - {<OpenLayers.Geometry>} 
-     * data - {Object} 
-     * style - {Object}
+     * geometry - {<OpenLayers.Geometry>} The geometry that this feature
+     *     represents.
+     * data - {Object} An optional object that will be mapped to <attributes>. 
+     * style - {Object} An optional style object.
      */
     initialize: function(geometry, data, style) {
         OpenLayers.Feature.prototype.initialize.apply(this, [null, null, data]);