Fix docs (#457)

* Fix docs

* Fix review comment -> add descriptive class comment

Author: mayurkale22

packages/opencensus-core/src/common/console-logger.ts

@@ -52,7 +52,7 @@ export class ConsoleLogger implements types.Logger {
 
   /**
    * Logger error function.
-   * @param message menssage erro to log in console
+   * @param message message error to log in console
    * @param args arguments to log in console
    */
   // tslint:disable-next-line:no-any
@@ -62,7 +62,7 @@ export class ConsoleLogger implements types.Logger {
 
   /**
    * Logger warning function.
-   * @param message menssage warning to log in console
+   * @param message message warning to log in console
    * @param args arguments to log in console
    */
   // tslint:disable-next-line:no-any
@@ -72,7 +72,7 @@ export class ConsoleLogger implements types.Logger {
 
   /**
    * Logger info function.
-   * @param message menssage info to log in console
+   * @param message message info to log in console
    * @param args arguments to log in console
    */
   // tslint:disable-next-line:no-any
@@ -82,7 +82,7 @@ export class ConsoleLogger implements types.Logger {
 
   /**
    * Logger debug function.
-   * @param message menssage debug to log in console
+   * @param message message debug to log in console
    * @param args arguments to log in console
    */
   // tslint:disable-next-line:no-any

packages/opencensus-core/src/common/time-util.ts

@@ -1,7 +1,7 @@
 /**
  * Copyright 2019, OpenCensus Authors
  *
- * Licensed under the Apache License, Version 2.0 the "License";
+ * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *

packages/opencensus-core/src/common/types.ts

@@ -17,7 +17,7 @@
 // tslint:disable:no-any
 export type LogFunction = (message: any, ...args: any[]) => void;
 
-/** Defines an logger interface. */
+/** Defines a logger interface. */
 export interface Logger {
   /** Logger verbosity level. If omitted, `debug` level is assumed. */
   level?: string;
@@ -28,7 +28,7 @@ export interface Logger {
   debug: LogFunction;
 }
 
-/** Defines an logger options interface. */
+/** Defines a logger options interface. */
 export interface LoggerOptions {
   level?: string;
 }

packages/opencensus-core/src/exporters/console-exporter.ts

@@ -18,12 +18,11 @@ import * as loggerTypes from '../common/types';
 import {Measurement, View} from '../stats/types';
 import {TagKey, TagValue} from '../tags/types';
 import * as modelTypes from '../trace/model/types';
-
 import {ExporterBuffer} from './exporter-buffer';
-import * as types from './types';
+import {Exporter, ExporterConfig, StatsEventListener} from './types';
 
 /** Do not send span data */
-export class NoopExporter implements types.Exporter {
+export class NoopExporter implements Exporter {
   logger?: loggerTypes.Logger;
   onStartSpan(root: modelTypes.RootSpan) {}
   onEndSpan(root: modelTypes.RootSpan) {}
@@ -33,7 +32,7 @@ export class NoopExporter implements types.Exporter {
 }
 
 /** Format and sends span data to the console. */
-export class ConsoleExporter implements types.Exporter {
+export class ConsoleExporter implements Exporter {
   /** Buffer object to store the spans. */
   // @ts-ignore
   private logger?: loggerTypes.Logger;
@@ -42,23 +41,26 @@ export class ConsoleExporter implements types.Exporter {
   /**
    * Constructs a new ConsoleLogExporter instance.
    * @param config Exporter configuration object to create a console log
-   * exporter.
+   *     exporter.
    */
-  constructor(config: types.ExporterConfig) {
+  constructor(config: ExporterConfig) {
     this.buffer = new ExporterBuffer(this, config);
     this.logger = config.logger;
   }
+
   onStartSpan(root: modelTypes.RootSpan) {}
+
   /**
    * Event called when a span is ended.
    * @param root Ended span.
    */
   onEndSpan(root: modelTypes.RootSpan) {
     this.buffer.addToBuffer(root);
   }
+
   /**
    * Sends the spans information to the console.
-   * @param rootSpans
+   * @param rootSpans A list of root spans to publish.
    */
   publish(rootSpans: modelTypes.RootSpan[]) {
     rootSpans.map((root) => {
@@ -79,7 +81,7 @@ export class ConsoleExporter implements types.Exporter {
 }
 
 /** Exporter that receives stats data and shows in the log console. */
-export class ConsoleStatsExporter implements types.StatsEventListener {
+export class ConsoleStatsExporter implements StatsEventListener {
   /**
    * Event called when a view is registered
    * @param view registered view

packages/opencensus-core/src/exporters/exporter-buffer.ts

@@ -73,6 +73,7 @@ export class ExporterBuffer {
   getQueue(): modelTypes.RootSpan[] {
     return this.queue;
   }
+
   /**
    * Add a rootSpan in the buffer.
    * @param root RootSpan to be added in the buffer.

packages/opencensus-core/src/exporters/types.ts

@@ -39,6 +39,7 @@ export interface StatsEventListener {
    * @param view The registered view
    */
   onRegisterView(view: View): void;
+
   /**
    * Is called whenever a new measurement is recorded.
    * @deprecated since version 0.0.9 - use {@link start} instead

packages/opencensus-core/src/index.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 
-
 // types
 export * from './trace/types';
 export * from './trace/model/types';
@@ -25,28 +24,7 @@ export * from './trace/propagation/types';
 export * from './exporters/types';
 export * from './common/types';
 export * from './metrics/gauges/types';
-import {Metric, MetricDescriptor, TimeSeries, MetricDescriptorType, LabelKey, LabelValue, Point as TimeSeriesPoint, DistributionValue, BucketOptions, Bucket as DistributionBucket, SummaryValue, Explicit, Exemplar, Timestamp, Snapshot, ValueAtPercentile, MetricProducerManager, MetricProducer} from './metrics/export/types';
-
-export {
-  Metric,
-  MetricDescriptor,
-  TimeSeries,
-  MetricDescriptorType,
-  LabelKey,
-  LabelValue,
-  TimeSeriesPoint,
-  DistributionValue,
-  BucketOptions,
-  DistributionBucket,
-  SummaryValue,
-  Explicit,
-  Exemplar,
-  Timestamp,
-  Snapshot,
-  ValueAtPercentile,
-  MetricProducerManager,
-  MetricProducer
-};
+export {Metric, MetricDescriptor, TimeSeries, MetricDescriptorType, LabelKey, LabelValue, Point as TimeSeriesPoint, DistributionValue, BucketOptions, Bucket as DistributionBucket, SummaryValue, Explicit, Exemplar, Timestamp, Snapshot, ValueAtPercentile, MetricProducerManager, MetricProducer} from './metrics/export/types';
 
 // classes
 
@@ -97,7 +75,6 @@ export * from './metrics/metric-registry';
 export * from './metrics/gauges/derived-gauge';
 export * from './metrics/gauges/gauge';
 
-
 // Stats singleton instance
 import {BaseStats} from './stats/stats';
 import {Stats} from './stats/types';

packages/opencensus-core/src/internal/clock.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 
-
 /**
  * The Clock class is used to record the duration and endTime for spans.
  */
@@ -52,7 +51,6 @@ export class Clock {
     return ns / 1e6;
   }
 
-
   /** Starts the clock. */
   get startTime(): Date {
     return this.startTimeLocal;

packages/opencensus-core/src/internal/string-utils.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2018 Google LLC
+ * Copyright 2018, OpenCensus Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -38,7 +38,7 @@ export class StringUtils {
   /**
    * Determines whether the Character is printable.
    *
-   * @param {string} str The Character to be validated.
+   * @param {string} ch The Character to be validated.
    * @returns {boolean} Whether the Character is printable.
    */
   static isPrintableChar(ch: string): boolean {

packages/opencensus-core/src/internal/util.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2018 Google LLC
+ * Copyright 2018, OpenCensus Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.