diff --git a/MIGRATING.md b/MIGRATING.md
index 6bb560c..4152722 100644
--- a/MIGRATING.md
+++ b/MIGRATING.md
@@ -28,7 +28,7 @@ In `0.3.x`, each function returned a Hash containing a parsed JSON representatio
 
 `0.4` introduced `Resource` - A base class used to encapsulate each JSON response.
 
-`Resource` can allow attributes to be accessed with dot notation. Alternatively, you can return a Hashed version of the resource using `Resource.attributes`. For example:
+`Resource` can allow attributes to be accessed by calling the attribute name on the instance. Alternatively, you can return a Hashed version of the resource using `Resource.attributes`. For example:
 
 ```ruby
 
diff --git a/README.md b/README.md
index 95ed329..738e31c 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,7 @@ Or install it yourself as:
 ## Usage
 
 ### Resources
-All client methods return  `Resource` objects or a collection of `Resource` objects. Every attribute from a resource can be accessed calling attribute methods:
+All client methods return  `Resource` objects or a collection of `Resource` objects. Every attribute from a resource can be accessed by calling attribute methods:
 
 ```ruby
 conversation = platform.conversations.find("fb2f3a48-523d-4449-a57f-c6651fc6612c")