/**
 * (C) 2011 Digi-Net Technologies, Inc.
 * 4420 Northwest 36th Avenue
 * Gainesville, FL 32606 USA
 * All rights reserved.
 */
package com.convert.rice;

public interface DataPoints extends Iterable<DataPoint> {

    /**
     * Returns the name of the series.
     * 
     * @return the metric name.
     */
    String getMetricName();

    /**
     * Returns the metric key.
     * 
     * @return the metric key.
     */
    String getKey();

    /**
     * Return the number of points in this metric.
     * 
     * @return
     */
    int size();

    /**
     * Returns the timestamp associated with the {@code i}th data point. The first data point has index 0.
     * <p>
     * This method must be implemented in <code>O({@link #aggregatedSize})</code> or better.
     * <p>
     * It is guaranteed that
     * 
     * <pre>
     * timestamp(i) &lt; timestamp(i + 1)
     * </pre>
     * 
     * @return A strictly positive integer.
     * @throws IndexOutOfBoundsException
     *             if {@code i} is not in the range <code>[0, {@link #size} - 1]</code>
     */
    long timestamp(int i);

    /**
     * Returns the value of the {@code i}th data point as a long. The first data point has index 0.
     * 
     */
    DataPoint get(int i);

    @Override
    SeekableView iterator();

    /**
     * @return
     */
    String toJson();

}

@@ -885,32 +885,104 @@
  %3C/pre%3E%0A     * %0A
+     * @param i%0A     *            index for the %7B@code i%7Dth data point.%0A
      * @return A
@@ -1005,24 +1005,24 @@
 ve integer.%0A
-
      * @thro
@@ -1189,25 +1189,97 @@
 %0A     * 
-R
+@param i%0A     *            an index for the %7B@code i%7Dth element.%0A     * @r
 eturn
-s t
+ T
 he value
@@ -1358,24 +1358,153 @@
  0.%0A     * %0A
+     * @throws IndexOutOfBoundsException%0A     *             if %7B@code i%7D is not in the range %3Ccode%3E%5B0, %7B@link #size%7D - 1%5D%3C/code%3E%0A
      */%0A    

Add proper comments to DataPoints