Revert "logging-{winston,bunyan}: improve API docs" (#2377)

This reverts commit 8b616ea. I didn't intend to push this to master. Will open a PR instead.
googleapis · Jun 12, 2017 · 2a20368 · 2a20368
1 parent 8b616ea
commit 2a20368
Show file tree

Hide file tree

Showing 4 changed files with 19 additions and 7 deletions.
diff --git a/packages/logging-bunyan/src/index.js b/packages/logging-bunyan/src/index.js
@@ -42,7 +42,15 @@ var BUNYAN_TO_STACKDRIVER = {
 
 /**
  * This module provides support for streaming your Bunyan logs to
- * [Stackdriver Logging](https://cloud.google.com/logging).
+ * [Stackdriver Logging]{@link https://cloud.google.com/logging}.
+ *
+ * If your app is running on Google Cloud Platform, all configuration and
+ * authentication is handled for you. We also auto-detect the appropriate
+ * resource descriptor to report the log entries against.
+ *
+ * If you are running your application in anther environment, such as locally,
+ * on-premise, or on another cloud provider, you will need to provide additional
+ * configuration.
  *
  * @constructor
  * @alias module:logging-bunyan

diff --git a/packages/logging-winston/src/index.js b/packages/logging-winston/src/index.js
@@ -61,7 +61,15 @@ var STACKDRIVER_LOGGING_LEVEL_CODE_TO_NAME = {
 
 /**
  * This module provides support for streaming your winston logs to
- * [Stackdriver Logging](https://cloud.google.com/logging).
+ * [Stackdriver Logging]{@link https://cloud.google.com/logging}.
+ *
+ * If your app is running on Google Cloud Platform, all configuration and
+ * authentication is handled for you. We also auto-detect the appropriate
+ * resource descriptor to report the log entries against.
+ *
+ * If you are running your application in another environment, such as locally,
+ * on-premise, or on another cloud provider, you will need to provide additional
+ * configuration.
  *
  * @constructor
  * @alias module:logging-winston

diff --git a/packages/logging/src/index.js b/packages/logging/src/index.js
@@ -60,8 +60,6 @@ var Sink = require('./sink.js');
 
  * @resource [What is Stackdriver Logging?]{@link https://cloud.google.com/logging/docs}
  * @resource [Introduction to the Stackdriver Logging API]{@link https://cloud.google.com/logging/docs/api}
- * @resource [Logging to Stackdriver from Bunyan]{@link https://www.npmjs.com/package/@google-cloud/logging-bunyan}
- * @resource [Logging to Stackdriver from Winston]{@link https://www.npmjs.com/package/@google-cloud/logging-winston}
  *
  * @param {object} options - [Configuration object](#/docs).
  */

diff --git a/scripts/docs/config.js b/scripts/docs/config.js
@@ -73,14 +73,12 @@ module.exports = {
       title: 'Cloud Natural Language'
     },
     logging: {
-      title: 'Stackdriver Logging'
+      title: 'Cloud Logging'
     },
     'logging-bunyan': {
-      title: 'Stackdriver Logging through Bunyan',
       skip: true
     },
     'logging-winston': {
-      title: 'Stackdriver Logging through Winston',
       skip: true
     },
     monitoring: {