diff --git a/README.md b/README.md
index 1da9ea32b..7f96eac91 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,12 @@ metadata = drive.insert_file(metadata, upload_source: 'test.txt', content_type:
 # Download a file
 drive.get_file(metadata.id, download_dest: '/tmp/myfile.txt')
 ```
+### Naming conventions vs JSON representation
+
+Object properties in the ruby client use the standard ruby convention for naming -- snake_case. This differs from the underlying JSON representation which typically uses camelCase for properties. There are a few notable exceptions to this rule:
+
+* For properties that are defined as hashes with user-defined keys, no translation is performed on the key.
+* For embedded field masks in requests (for example, the Sheets API), specify the camelCase form when referencing fields.
 
 ### Media