Update Translate sample README and rename sample file

Author: remi Taylor

translate/README.md

@@ -1,3 +1,35 @@
 <img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
 
 # Google Cloud Translate API Ruby Samples
+
+
+With the [Google Translate API][translate_docs], you can dynamically translate
+text between thousands of language pairs.
+
+[translate_docs]: https://cloud.google.com/translate/docs/
+
+## Run sample
+
+To run the sample, first install dependencies:
+
+    bundle install
+
+Run the sample:
+
+    bundle exec ruby translate_samples.rb
+
+Usage:
+
+  Usage: ruby translate_samples.rb <command> [arguments]
+
+  Commands:
+    translate       <desired-language-code> <text>
+    detect_language <text>
+    list_names      <language-code-for-display>
+    list_codes
+
+  Examples:
+    ruby translate_samples.rb translate fr "Hello World"
+    ruby translate_samples.rb detect_language "Hello World"
+    ruby translate_samples.rb list_codes
+    ruby translate_samples.rb list_names en

translate/spec/translate_spec.rb translate/spec/translate_samples_spec.rbtranslate/spec/translate_spec.rb renamed to translate/spec/translate_samples_spec.rb

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require_relative "../samples"
+require_relative "../translate_samples"
 require "rspec"
 
 RSpec.describe "Google Translate API samples" do

translate/samples.rb translate/translate_samples.rbtranslate/samples.rb renamed to translate/translate_samples.rb

@@ -98,19 +98,19 @@ def list_supported_language_names api_key:, language_code: "en"
     list_supported_language_names api_key: api_key, language_code: ARGV.shift
   else
     puts <<-usage
-Usage: ruby samples.rb <command> [arguments]
+Usage: ruby translate_samples.rb <command> [arguments]
 
 Commands:
-  translate <desired-language-code> "<text>"
-  detect_language "<text>"
+  translate       <desired-language-code> <text>
+  detect_language <text>
+  list_names      <language-code-for-display>
   list_codes
-  list_names <language-code-for-display>
 
 Examples:
-  ruby samples.rb translate fr "Hello World"
-  ruby samples.rb detect_language "Hello World"
-  ruby samples.rb list_codes
-  ruby samples.rb list_names en
+  ruby translate_samples.rb translate fr "Hello World"
+  ruby translate_samples.rb detect_language "Hello World"
+  ruby translate_samples.rb list_codes
+  ruby translate_samples.rb list_names en
     usage
   end
 end