README.md in google-cloud-secret_manager-v1-0.2.1 vs README.md in google-cloud-secret_manager-v1-0.3.0
- old
+ new
@@ -1,6 +1,6 @@
-# Secret Manager V1
+# Ruby Client for the Secret Manager V1 API
API Client library for the Secret Manager V1 API
Secret Manager is a secure and convenient storage system for API keys, passwords, certificates, and other sensitive data. Secret Manager provides a central place and single source of truth to manage, access, and audit secrets across Google Cloud.
@@ -8,9 +8,56 @@
## Installation
```
$ gem install google-cloud-secret_manager-v1
+```
+
+## Before You Begin
+
+In order to use this library, you first need to go through the following steps:
+
+1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+1. {file:AUTHENTICATION.md Set up authentication.}
+
+## Quick Start
+
+```ruby
+require "google/cloud/secret_manager/v1"
+
+client = Google::Cloud::SecretManager::V1::SecretManagerService::Client.new
+request = my_create_request
+response = client.list_secrets request
+```
+
+View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-secret_manager-v1/latest)
+for class and method documentation.
+
+## Enabling Logging
+
+To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+
+Configuring a Ruby stdlib logger:
+
+```ruby
+require "logger"
+
+module MyLogger
+ LOGGER = Logger.new $stderr, level: Logger::WARN
+ def logger
+ LOGGER
+ end
+end
+
+# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+module GRPC
+ extend MyLogger
+end
```
## Supported Ruby Versions
This library is supported on Ruby 2.4+.