docs(api-metrics): add notes on ObservableResult.observe (#2712)

Co-authored-by: Valentin Marchaud <[email protected]>
Co-authored-by: Daniel Dyla <[email protected]>

experimental/packages/opentelemetry-api-metrics/src/types/ObservableResult.ts

@@ -20,5 +20,13 @@ import { Attributes } from './Metric';
  * Interface that is being used in callback function for Observable Metric
  */
 export interface ObservableResult {
+ /**
+ * Observe a measurement of the value associated with the given attributes.
+ *
+ * @param value The value to be observed.
+ * @param attributes The attributes associated with the value. If more than
+ * one values associated with the same attributes values, SDK may pick the
+ * last one or simply drop the entire observable result.
+ */
  observe(value: number, attributes?: Attributes): void;
 }