diff --git a/lib/geocoder/results/base.rb b/lib/geocoder/results/base.rb
index 8a42413f229dff258629fb64785518eee212f3e2..a798ced6852dea49b1eaa8f23fe75298bd07021d 100644
--- a/lib/geocoder/results/base.rb
+++ b/lib/geocoder/results/base.rb
@@ -1,10 +1,16 @@
 module Geocoder
   module Result
     class Base
-      attr_accessor :data, :cache_hit
+
+      # data (hash) fetched from geocoding service
+      attr_accessor :data
+
+      # true if result came from cache, false if from request to geocoding
+      # service; nil if cache is not configured
+      attr_accessor :cache_hit
 
       ##
-      # Takes a hash of result data from a parsed Google result document.
+      # Takes a hash of data from a parsed geocoding service response.
       #
       def initialize(data)
         @data = data