diff --git a/.changeset/sweet-bags-listen.md b/.changeset/sweet-bags-listen.md
new file mode 100644
index 000000000..89b695455
--- /dev/null
+++ b/.changeset/sweet-bags-listen.md
@@ -0,0 +1,5 @@
+---
+'@lion/ajax': major
+---
+
+First major release (no difference with 0.16.0)
diff --git a/README.md b/README.md
index 958331cf8..c8095a42a 100644
--- a/README.md
+++ b/README.md
@@ -91,9 +91,12 @@ There's a couple of "systems" in lion which have a JavaScript API. Examples are
 <script type="module">
   import { ajax } from '@lion/ajax';
 
-  ajax.get('data.json').then(response => {
-    // most likely you will use response.data
-  });
+  ajax
+    .fetch('data.json')
+    .then(response => response.json())
+    .then(data => {
+      // do something with the data
+    });
 </script>
 ```
 
diff --git a/docs/guides/how-to/get-started.md b/docs/guides/how-to/get-started.md
index 34a0147a9..026bbe354 100644
--- a/docs/guides/how-to/get-started.md
+++ b/docs/guides/how-to/get-started.md
@@ -55,9 +55,12 @@ There's a couple of "systems" in lion which have a JavaScript API. Examples are
 <script type="module">
   import { ajax } from '@lion/ajax';
 
-  ajax.get('data.json').then(response => {
-    // most likely you will use response.data
-  });
+  ajax
+    .fetch('data.json')
+    .then(response => response.json())
+    .then(data => {
+      // do something with the data
+    });
 </script>
 ```