Revise and edit docs

exporters/stdout/stdoutmetric/doc.go

@@ -15,9 +15,9 @@
 // Package stdoutmetric provides an exporter for OpenTelemetry metric
 // telemetry.
 //
-// The exporter is intended to be used for testing and debugging. It is not an
-// exporter meant for production use. Additionally, it does not provide an
-// interchange format for OpenTelemetry that is supported with any stability
-// or compatibility guarantees. If these are needed features, please use the
-// OTLP exporter instead.
+// The exporter is intended to be used for testing and debugging, it is not
+// meant for production use. Additionally, it does not provide an interchange
+// format for OpenTelemetry that is supported with any stability or
+// compatibility guarantees. If these are needed features, please use the OTLP
+// exporter instead.
 package stdoutmetric // import "go.opentelemetry.io/otel/exporters/stdout/stdoutmetric"

exporters/stdout/stdoutmetric/encoder.go

@@ -22,8 +22,7 @@ import "errors"
 // Encoder encodes and outputs OpenTelemetry metric data-types as human
 // readable text.
 type Encoder interface {
-	// Encode handles the encoding and writing OpenTelemetry metric data-types
-	// that the exporter will pass to it.
+	// Encode handles the encoding and writing of OpenTelemetry metric data.
 	Encode(v any) error
 }
 

exporters/stdout/stdoutmetric/exporter.go

@@ -33,10 +33,10 @@ type exporter struct {
 	shutdownOnce sync.Once
 }
 
-// New returns a configured metric Exporter.
+// New returns a configured metric exporter.
 //
 // If no options are passed, the default exporter returned will use a JSON
-// encoder with tab indentations.
+// encoder with tab indentations that output to STDOUT.
 func New(options ...Option) (metric.Exporter, error) {
 	cfg := newConfig(options...)
 	exp := &exporter{}