Update documentation for Gauge & Counters

accumulator.go

@@ -2,7 +2,13 @@ package telegraf
 
 import "time"
 
+// Accumulator is an interface for "accumulating" metrics from input plugin(s).
+// The metrics are sent down a channel shared between all input plugins and then
+// flushed on the configured flush_interval.
 type Accumulator interface {
+	// AddFields adds a metric to the accumulator with the given measurement
+	// name, fields, and tags (and timestamp). If a timestamp is not provided,
+	// then the accumulator sets it to "now".
 	// Create a point with a value, decorating it with tags
 	// NOTE: tags is expected to be owned by the caller, don't mutate
 	// it after passing to Add.
@@ -11,15 +17,13 @@ type Accumulator interface {
 		tags map[string]string,
 		t ...time.Time)
 
-	// AddGauge is the same as AddFields, but will add the metric as a "Gauge"
-	// type
+	// AddGauge is the same as AddFields, but will add the metric as a "Gauge" type
 	AddGauge(measurement string,
 		fields map[string]interface{},
 		tags map[string]string,
 		t ...time.Time)
 
-	// AddCounter is the same as AddFields, but will add the metric as a "Counter"
-	// type
+	// AddCounter is the same as AddFields, but will add the metric as a "Counter" type
 	AddCounter(measurement string,
 		fields map[string]interface{},
 		tags map[string]string,