diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5e1bc849..10f04d8d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,7 +2,7 @@
 
 #### Features
 
-* [#667](https://github.com/ruby-grape/grape-swagger/pull/667):  Make route summary optional - [@obduk](https://github.com/obduk).
+* [#667](https://github.com/ruby-grape/grape-swagger/pull/667): Make route summary optional - [@obduk](https://github.com/obduk).
 * [#670](https://github.com/ruby-grape/grape-swagger/pull/670): Add support for deprecated field - [@ioanatia](https://github.com/ioanatia).
 
 * Your contribution here.
@@ -11,6 +11,7 @@
 
 * [#664](https://github.com/ruby-grape/grape-swagger/pull/662): Removed all references to obsolete `hide_format` parameter - [@jonmchan](https://github.com/jonmchan).
 * [#669](https://github.com/ruby-grape/grape-swagger/pull/669): Fix handling of http status codes from routes - [@milgner](https://github.com/milgner).
+* [#672](https://github.com/ruby-grape/grape-swagger/pull/672): Rename 'notes' to 'detail' in README - [@kjleitz](https://github.com/kjleitz).
 
 ### 0.28.0 (February 3, 2018)
 
diff --git a/README.md b/README.md
index 78763581..1ca8ecf7 100644
--- a/README.md
+++ b/README.md
@@ -1215,7 +1215,7 @@ class NamespaceApi < Grape::API
     end
 
     desc 'This gets something.',
-      notes: '_test_'
+      detail: '_test_'
 
     get '/simple' do
       { bla: 'something' }