diff --git a/lib/google/api_client/discovery.rb b/lib/google/api_client/discovery.rb
index a1e36bf37..261a20caa 100644
--- a/lib/google/api_client/discovery.rb
+++ b/lib/google/api_client/discovery.rb
@@ -121,6 +121,10 @@ module Google
       # Converts the service to a flat mapping of RPC names and method objects.
       #
       # @return [Hash] All methods available on the service.
+      #
+      # @example
+      #   # Discover available methods
+      #   method_names = client.discovered_service('buzz').to_h.keys
       def to_h
         return @hash ||= (begin
           methods_hash = {}
@@ -138,10 +142,6 @@ module Google
       # Returns a <code>String</code> representation of the service's state.
       #
       # @return [String] The service's state, as a <code>String</code>.
-      #
-      # @example
-      #   # Discover available methods
-      #   method_names = client.discovered_service('buzz').to_h.keys
       def inspect
         sprintf(
           "#<%s:%#0x NAME:%s>", self.class.to_s, self.object_id, self.name