stackdriver 0.15.1 → 0.15.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cfbd8e9c77b8bbf44cdf81627beac4757b9a6b9bd9a9a1e9473f11c970e5bf0
-  data.tar.gz: 18f4cd6661281242f2ecee3f09b08c0f0c74c524ab95db38df418e2d37ae672d
+  metadata.gz: a80e07c15259fe692a9a3f046d8b5dffad1cd2973846bb24dded9fe23d81ab0b
+  data.tar.gz: 98dbd5983c35a5f071a7fb175a82f7a5efb58b3ca878ef6082f4309b880396ee
 SHA512:
-  metadata.gz: 8726fdb0d699adcc0fa92dbd3a8b47e7d7ec5e70695bf151b4be752f48dca3e89c286ae33ae64f165566a00c8bc8c84696a58910710ccc4f18b3bb25ab7c02f6
-  data.tar.gz: 5a2df83be3070c12adc01791fa74f22ba17b003dd9e0df69260e7c9a5bd2784e62f98af0aba1335058edbed781ba147f8af25fe5699b14627fb2b373577f2252
+  metadata.gz: 55c0dbf52776c67e912d4cd6bb67e57f9137fc8dfb4d20ad83e5d2303d051f0c54bdba50ee499394b79c86a166456fc8ef24f109aa8ca4d2ad8e4ffba1a25258
+  data.tar.gz: 300c58e8b8a2d3dd5a58509e2215f73f0df3f4447add3cb889db572e8421dc4a934875d90a0f9003f5f29c07d7bc67e6a89bd36fc56ec637969fc332eb6fc5a1

data/CHANGELOG.md

@@ -0,0 +1,100 @@
+# Release History
+
+### 0.15.2 / 2018-09-12
+
+* Add missing documentation files to package.
+
+### 0.15.1 / 2018-09-10
+
+* Update documentation.
+
+### 0.15.0 / 2018-05-24
+
+* Debugger 0.32.0
+* Trace 0.33.0
+
+### 0.14.0 / 2018-02-27
+
+* Debugger 0.31.0
+  * Use Google Cloud Shared Configuration.
+  * Fix for mutation detection using Ruby 2.5.
+  * Support disabling mutation detection in debugger evaluation.
+* Error Reporting 0.30.0
+  * Use Google Cloud Shared Configuration.
+* Logging 1.5.0
+  * Use Google Cloud Shared Configuration.
+  * Deprecated Logging Sink attributes.
+* Trace 0.31.0
+  * Use Google Cloud Shared Configuration.
+  * Update authentication documentation.
+
+### 0.13.0 / 2017-12-19
+
+* Trace 0.30.0 release.
+
+### 0.12.0 / 2017-12-19
+
+* Debugger 0.30.0 release.
+* Error Reporting 0.29.0 release.
+* Logging 1.4.0 release.
+* Trace 0.29.0 release.
+
+### 0.11.0 / 2017-11-14
+
+* Debugger 0.29.0 release.
+* Error Reporting 0.28.0 release.
+* Logging 1.3.0 release.
+* Trace 0.28.0 release.
+
+### 0.10.0 / 2017-09-08
+
+* Error Reporting 0.27.0 release.
+
+### 0.9.0 / 2017-08-25
+
+* Debugger 0.28.0 release.
+
+### 0.8.0 / 2017-08-07
+
+* Debugger 0.27.0 release.
+* Trace 0.27.0 release.
+
+### 0.7.0 / 2017-07-11
+
+* Debugger 0.26.0 release.
+* Error Reporting 0.26.0 release.
+* Logging 1.2.0 release.
+* Trace 0.26.0 release.
+
+### 0.6.0 / 2017-05-25
+
+* Debugger 0.25.0 release.
+* Error Reporting 0.25.0 release.
+* Logging 1.1.0 release.
+* Trace 0.25.0 release.
+* Remove `google-cloud-monitoring` from this umbrella gem.
+
+### 0.5.0 / 2017-03-31
+
+* Logging 1.0 release
+* Updated dependencies on all other gems
+
+### 0.4.1 / 2017-02-27
+
+* Set version constraints on the gem dependencies for individual stackdriver services. Current versions are:
+  * **google-cloud-logging** `~> 0.24.0`
+  * **google-cloud-error_reporting** `~> 0.23.1`
+  * **google-cloud-monitoring** `~> 0.23.0`
+  * **google-cloud-trace** `~> 0.23.0`
+
+### 0.4.0 / 2016-12-22
+
+* Now provides Stackdriver Trace instrumentation by including google-cloud-trace.
+
+### 0.3.0 / 2016-11-07
+
+This gem is an umbrella gem that serves as the single drop-in gem for users interested in using the Stackdriver services from their Ruby applications.
+
+The initial release of stackdriver gem includes the following Stackdriver gems to be used in Ruby applications:
+* google-cloud-logging
+* google-cloud-error_reporting

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,40 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct. By adopting this Code of Conduct, project
+maintainers commit themselves to fairly and consistently applying these
+principles to every aspect of managing this project. Project maintainers who do
+not follow or enforce the Code of Conduct may be permanently removed from the
+project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by opening an issue or contacting one or more of the project
+maintainers.
+
+This Code of Conduct is adapted from the [Contributor
+Covenant](http://contributor-covenant.org), version 1.2.0, available at
+[http://contributor-covenant.org/version/1/2/0/](http://contributor-covenant.org/version/1/2/0/)

data/CONTRIBUTING.md

@@ -0,0 +1,128 @@
+# Contributing to Google Cloud Stackdriver
+
+1. **Sign one of the contributor license agreements below.**
+2. Fork the repo, develop and test your code changes.
+3. Send a pull request.
+
+## Contributor License Agreements
+
+Before we can accept your pull requests you'll need to sign a Contributor
+License Agreement (CLA):
+
+- **If you are an individual writing original source code** and **you own the
+  intellectual property**, then you'll need to sign an [individual
+  CLA](https://developers.google.com/open-source/cla/individual).
+- **If you work for a company that wants to allow you to contribute your work**,
+  then you'll need to sign a [corporate
+  CLA](https://developers.google.com/open-source/cla/corporate).
+
+You can sign these electronically (just scroll to the bottom). After that, we'll
+be able to accept your pull requests.
+
+## Setup
+
+In order to use the stackdriver console and run the project's tests,
+there is a small amount of setup:
+
+1. Install Ruby. stackdriver requires Ruby 2.3+. You may choose to
+   manage your Ruby and gem installations with [RVM](https://rvm.io/),
+   [rbenv](https://github.com/rbenv/rbenv), or
+   [chruby](https://github.com/postmodern/chruby).
+
+2. Install [Bundler](http://bundler.io/).
+
+   ```sh
+   $ gem install bundler
+   ```
+
+3. Install the top-level project dependencies.
+
+   ```sh
+   $ bundle install
+   ```
+
+4. Install the Stackdriver dependencies.
+
+   ```sh
+   $ cd stackdriver/
+   $ bundle exec rake bundleupdate
+   ```
+
+## Stackdriver Tests
+
+Tests are very important part of stackdriver. All contributions
+should include tests that ensure the contributed code behaves as expected.
+
+To run the unit tests, documentation tests, and code style checks together for a
+package:
+
+``` sh
+$ cd stackdriver/
+$ bundle exec rake ci
+```
+
+To run the command above, plus all acceptance tests, use `rake ci:acceptance` or
+its handy alias, `rake ci:a`.
+
+### Stackdriver Unit Tests
+
+
+The project uses the [minitest](https://github.com/seattlerb/minitest) library,
+including [specs](https://github.com/seattlerb/minitest#specs),
+[mocks](https://github.com/seattlerb/minitest#mocks) and
+[minitest-autotest](https://github.com/seattlerb/minitest-autotest).
+
+To run the Stackdriver unit tests:
+
+``` sh
+$ cd stackdriver/
+$ bundle exec rake test
+```
+
+### Stackdriver Documentation Tests
+
+The project tests the code examples in the gem's
+[YARD](https://github.com/lsegal/yard)-based documentation.
+
+The example testing functions in a way that is very similar to unit testing, and
+in fact the library providing it,
+[yard-doctest](https://github.com/p0deje/yard-doctest), is based on the
+project's unit test library, [minitest](https://github.com/seattlerb/minitest).
+
+To run the Stackdriver documentation tests:
+
+``` sh
+$ cd stackdriver/
+$ bundle exec rake doctest
+```
+
+If you add, remove or modify documentation examples when working on a pull
+request, you may need to update the setup for the tests. The stubs and mocks
+required to run the tests are located in `support/doctest_helper.rb`. Please
+note that much of the setup is matched by the title of the
+[`@example`](http://www.rubydoc.info/gems/yard/file/docs/Tags.md#example) tag.
+If you alter an example's title, you may encounter breaking tests.
+
+## Coding Style
+
+Please follow the established coding style in the library. The style is is
+largely based on [The Ruby Style
+Guide](https://github.com/bbatsov/ruby-style-guide) with a few exceptions based
+on seattle-style:
+
+* Avoid parenthesis when possible, including in method definitions.
+* Always use double quotes strings. ([Option
+  B](https://github.com/bbatsov/ruby-style-guide#strings))
+
+You can check your code against these rules by running Rubocop like so:
+
+```sh
+$ cd stackdriver/
+$ bundle exec rake rubocop
+```
+
+## Code of Conduct
+
+Please note that this project is released with a Contributor Code of Conduct. By
+participating in this project you agree to abide by its terms. See
+{file:CODE_OF_CONDUCT.md Code of Conduct} for more information.

data/INSTRUMENTATION_CONFIGURATION.md

@@ -0,0 +1,116 @@
+# Stackdriver Instrumentation Configuration
+
+Stackdriver instrumentation libraries are fully integrated with Rails
+configuration interface. You can provide all the configuration parameters in
+your `config/environments/*.rb` files:
+
+```ruby
+Rails.application.configure do |config|
+  # Shared project_id and keyfile
+  config.google_cloud.project_id = "my-project"
+  config.google_cloud.keyfile = "/path/to/key.json"
+
+  # Library specific configurations
+  config.google_cloud.error_reporting.project_id = "error-reporting-project"
+  config.google_cloud.logging.log_name = "my-app-logname"
+  config.google_cloud.trace.capture_stack = true
+end
+```
+
+Other Rack-based applications can also configure all the Stackdriver
+instrumentation libraries through a similar configuration interface in Ruby:
+
+```ruby
+Google::Cloud.configure do |config|
+  # Shared project_id and keyfile
+  config.project_id = "my-project"
+  config.keyfile = "/path/to/key.json"
+
+  # Library specific configurations
+  config.error_reporting.project_id = "error-reporting-project"
+  config.logging.log_name = "my-app-log"
+  config.trace.capture_stack = true
+end
+```
+
+Individual libraries can be configured separately:
+
+```ruby
+# Error Reporting specific configurations
+Google::Cloud::ErrorReporting.configure do |config|
+  config.project_id = "error-reporting-project"
+  config.service_name = "my-service"
+end
+
+# Debugger specific configurations
+Google::Cloud::Debugger.configure do |config|
+  config.project_id = "debugger-project"
+  config.service_name = "my-service"
+  config.allow_mutating_methods = true
+end
+
+# Logging specific configurations
+Google::Cloud::Logging.configure do |config|
+  config.project_id = "error-reporting-project"
+  config.log_name = "my-app-log"
+  config.google_cloud.labels = {
+    "my-static-label" => "static-label-value",
+    "my-dynamic-label" => ->(rack_env) { rack_env["HTTP_X_MY_HEADER"] }
+  }
+end
+
+# Trace specific configurations
+Google::Cloud::Trace.configure do |config|
+  config.project_id = "error-reporting-project"
+  config.capture_stack = true
+end
+```
+
+## Configuration Options
+
+#### Shared
+
+* `project_id`: [`String`] Shared Google Cloud Platform Project identifier. Self discovered on GCP.
+* `credentials`: [`String`] Path to shared service account JSON keyfile. Self discovered on GCP.
+* `use_error_reporting`: [`Boolean`] Explicitly enable or disable Error Reporting features. Default: `Rails.env.production?`
+* `use_debugger`: [`Boolean`] Explicitly enable or disable Debugger features. Default: `Rails.env.production?`
+* `use_logging`: [`Boolean`] Explicitly enable or disable Logging features. Default: `Rails.env.production?`
+* `use_trace`: [`Boolean`] Explicitly enable or disable Trace features. Default: `Rails.env.production?`
+
+#### Error Reporting
+
+* `error_reporting.project_id`: [`String`] Google Cloud Platform Project identifier just for Error Reporting. Self discovered on GCP.
+* `error_reporting.credentials`: [`String`] Path to service account JSON keyfile. Self discovered on GCP.
+* `error_reporting.service_name`: [`String`] Identifier to running service. Self discovered on GCP. Default: `"ruby"`
+* `error_reporting.service_version`: [`String`] Version identifier to running service. Self discovered on GCP.
+* `error_reporting.ignore_classes`: [`Array`] An Array of Exception classes to ignore. Default: `[]`
+
+#### Debugger
+
+* `debugger.project_id`: [`String`] Google Cloud Platform Project identifier just for Debugger. Self discovered on GCP.
+* `debugger.credentials`: [`String`] Path to service account JSON keyfile. Self discovered on GCP.
+* `debugger.service_name`: [`String`] Identifier to running service. Self discovered on GCP. Default: `"ruby-app"`
+* `debugger.service_version`: [`String`] Version identifier to running service. Self discovered on GCP.
+* `debugger.root`: [`String`] The root directory of the debuggee application in absolute file path form. Default: `Rack::Directory#root` if the application framework is rack-based,i.e. Ruby on Rails, Sinatra. Otherwise use current working directory.
+* `debugger.allow_mutating_methods`: [`boolean`] Whether to allow expressions to call methods that could mutate program state. Default is `false`.
+* `debugger.evaluation_time_limit`: [`Numeric`] The time limit in seconds for evaluating expressions. Default is `0.05`.
+
+#### Logging
+
+* `logging.project_id`: [`String`] Google Cloud Platform Project identifier just for Logging. Self discovered on GCP.
+* `logging.credentials`: [`String`] Path to service account JSON keyfile. Self discovered on GCP.
+* `logging.log_name`: [`String`] Name of the application log file. Default: `"ruby_app_log"`
+* `logging.log_name_map`: [`Hash`] Map specific request routes to other log. Default: `{ "/_ah/health" => "ruby_health_check_log" }`
+* `logging.monitored_resource.type`: [`String`] Resource type name. See [full list](https://cloud.google.com/logging/docs/api/v2/resource-list). Self discovered on GCP.
+* `logging.monitored_resource.labels`: [`Hash`] Resource labels. See [full list](https://cloud.google.com/logging/docs/api/v2/resource-list). Self discovered on GCP.
+* `logging.labels`: [`Hash`] User defined labels. A `Hash` of label names to string label values or callables/`Proc` which are functions of the Rack environment.
+
+#### Trace
+
+* `trace.project_id`: [`String`] Google Cloud Platform Project identifier just for Trace. Self discovered on GCP.
+* `trace.credentials`: [`String`] Path to service account JSON keyfile. Self discovered on GCP.
+* `trace.capture_stack`: [`Boolean`] Whether to capture stack traces for each span. Default: `false`
+* `trace.sampler`: [`Proc`] A sampler Proc makes the decision whether to record a trace for each request. Default: `Google::Cloud::Trace::TimeSampler`
+* `trace.span_id_generator`: [`Proc`] A generator Proc that generates the name String for new TraceRecord. Default: `random numbers`
+* `trace.notifications`: [`Array`] An array of ActiveSupport notification types to include in traces. Rails-only option. Default: `Google::Cloud::Trace::Railtie::DEFAULT_NOTIFICATIONS`
+* `trace.max_data_length`: [`Integer`] The maximum length of span properties recorded with ActiveSupport notification events. Rails-only option. Default: `Google::Cloud::Trace::Notifications::DEFAULT_MAX_DATA_LENGTH`

data/OVERVIEW.md

@@ -0,0 +1,31 @@
+# Stackdriver
+
+The stackdriver gem instruments a Ruby web application for Stackdriver
+diagnostics. When loaded, it integrates with Rails, Sinatra, or other Rack-based
+web frameworks to collect application diagnostic and monitoring information for
+your application.
+
+Specifically, this gem is a convenience package that loads the following gems:
+
+- [google-cloud-debugger](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-debugger)
+- [google-cloud-error_reporting](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-error_reporting)
+- [google-cloud-logging](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-logging)
+- [google-cloud-trace](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-trace)
+
+On top of that, stackdriver gem automatically activates the following
+instrumentation features:
+
+- [google-cloud-debugger instrumentation](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-debugger/latest/file.INSTRUMENTATION)
+- [google-cloud-error_reporting strumentation](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-error_reporting/latest/file.INSTRUMENTATION)
+- [google-cloud-logging instrumentation](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/file.INSTRUMENTATION)
+- [google-cloud-trace instrumentation](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-trace/latest/file.INSTRUMENTATION)
+
+## Usage
+
+Instead of requiring multiple Stackdriver client library gems and explicitly
+load each built-in Railtie classes, now users can achieve all these through
+requiring this single **stackdriver** umbrella gem.
+
+```ruby
+require "stackdriver"
+```

data/lib/stackdriver/version.rb

@@ -14,5 +14,5 @@
 
 
 module Stackdriver
-  VERSION = "0.15.1".freeze
+  VERSION = "0.15.2".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stackdriver
 version: !ruby/object:Gem::Version
-  version: 0.15.1
+  version: 0.15.2
 platform: ruby
 authors:
 - Heng Xiong
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-10 00:00:00.000000000 Z
+date: 2018-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-debugger
@@ -228,8 +228,12 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- INSTRUMENTATION_CONFIGURATION.md
 - LICENSE
-- README.md
+- OVERVIEW.md
 - lib/stackdriver.rb
 - lib/stackdriver/version.rb
 homepage: https://github.com/GoogleCloudPlatform/google-cloud-ruby/tree/master/stackdriver

data/README.md

@@ -1,148 +0,0 @@
-# stackdriver
-
-This gem instruments a Ruby web application for Stackdriver diagnostics. When
-loaded, it integrates with Rails, Sinatra, or other Rack-based web frameworks
-to collect application diagnostic and monitoring information for your
-application.
-
-Specifically, this gem is a convenience package that loads and automatically
-activates the instrumentation features of the following gems:
-
-*   [google-cloud-debugger](../google-cloud-debugger) which enables remote
-    debugging using [Stackdriver Debugger](https://cloud.google.com/debugger/)
-*   [google-cloud-error_reporting](../google-cloud-error_reporting) which
-    reports unhandled exceptions and other errors to
-    [Stackdriver Error Reporting](https://cloud.google.com/error-reporting/)
-*   [google-cloud-logging](../google-cloud-logging) which collects application
-    logs in [Stackdriver logging](https://cloud.google.com/logging/)
-*   [google-cloud-trace](../google-cloud-trace) which reports distributed
-    latency traces to [Stackdriver Trace](https://cloud.google.com/trace/)
-
-## Quick Start
-
-### Install the gem
-
-Add the `stackdriver` gem to your Gemfile:
-
-```ruby
-gem "stackdriver"
-```
-
-### Instrument your code
-
-#### Using Ruby on Rails
-
-If you are running Ruby on Rails, the `stackdriver` gem will automatically
-install Railties that will instrument your application for basic diagnostics.
-In most applications, the gem will initialize itself, and you will not need to
-write any additional code.
-
-If your Rails application has removed the `Bundler.require` line in the
-`application.rb` initialization file, then you might need to require the gem
-explicitly with:
-
-```ruby
-# In application.rb
-require "stackdriver"
-```
-
-#### Other Rack-based frameworks
-
-If you are running another Rack-based framework, such as Sinatra, you should
-install the Rack Middleware provided by each library you want to use:
-
-```ruby
-# In your Rack middleware configuration code.
-require "stackdriver"
-use Google::Cloud::Logging::Middleware
-use Google::Cloud::ErrorReporting::Middleware
-use Google::Cloud::Trace::Middleware
-use Google::Cloud::Debugger::Middleware
-```
-
-#### Advanced instrumentation
-
-See the individual gem documentation for each gem for information on how to
-customize the instrumentation, e.g. how to manually report errors or add custom
-spans to latency traces.
-
-### Viewing diagnostic reports
-
-Logs, errors, traces, and other reports can be viewed on the Google Cloud
-Console. If your app is hosted on Google Cloud (such as on Google App Engine,
-Google Kubernetes Engine, or Google Compute Engine), you can use the same
-project. Otherwise, if your application is hosted elsewhere, create a new
-project on [Google Cloud](https://console.cloud.google.com/).
-
-Make sure the [Stackdriver Error Reporting
-API](https://console.cloud.google.com/apis/library/clouderrorreporting.googleapis.com)
-is enabled on your Google Cloud project. (The other service APIs---debugging,
-logging, and tracing---are enabled by default on all new projects.)
-
-#### Authentication
-
-Your app also needs to authenticate with the Stackdriver services in order to
-send data.
-
-*   If you are running on **Google App Engine**, authentication happens
-    automatically. You do not need to do anything.
-*   If you are running on **Google Kubernetes Engine**, you must explicitly add
-    `https://www.googleapis.com/auth/cloud-platform` to the API access scopes
-    when creating the cluster. Authentication will then happen automatically.
-*   If you are running on **Google Compute Engine**, you must explicitly add
-    `https://www.googleapis.com/auth/cloud-platform` to the API access scopes
-    when creating the VM. Authentication will then happen automatically.
-*   If you are not running on a Google Cloud hosting environment, you must set
-    up a service account, and provide the Stackdriver library with the ID of
-    your Google Cloud project, and the service account credentials.
-
-    ```ruby
-    # In your app initialization code
-    Google::Cloud.configure do |config|
-      config.project_id = "your-project-id"
-      config.credentials = "/path/to/servce-account-keyfile.json"
-    end
-    ```
-
-See the gem documentation for each individual gem for more information.
-
-## Supported Ruby Versions
-
-This library is supported on Ruby 2.3+.
-
-Google provides official support for Ruby versions that are actively supported
-by Ruby Core—that is, Ruby versions that are either in normal maintenance or in
-security maintenance, and not end of life. Currently, this means Ruby 2.3 and
-later. Older versions of Ruby _may_ still work, but are unsupported and not
-recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
-about the Ruby support schedule.
-
-This library follows [Semantic Versioning](http://semver.org/). It is currently
-in major version zero (0.y.z), which means that anything may change at any time
-and the public API should not be considered stable.
-
-## Contributing
-
-Contributions to this library are always welcome and highly encouraged.
-
-See the [Contributing
-Guide](http://googlecloudplatform.github.io/google-cloud-ruby/docs/stackdriver/latest/file.CONTRIBUTING)
-for more information on how to get started.
-
-Please note that this project is released with a Contributor Code of Conduct. By
-participating in this project you agree to abide by its terms. See [Code of
-Conduct](http://googlecloudplatform.github.io/google-cloud-ruby/docs/stackdriver/latest/file.CODE_OF_CONDUCT)
-for more information.
-
-## License
-
-This library is licensed under Apache 2.0. Full license text is available in
-[LICENSE](LICENSE).
-
-## Support
-
-Please [report bugs at the project on
-Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues). Don't
-hesitate to [ask
-questions](http://stackoverflow.com/questions/tagged/google-cloud-ruby) about
-the client or APIs on [StackOverflow](http://stackoverflow.com).