From e382b4fee529abdd4d2ca1d27144f2032da9313d Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Mon, 17 May 2021 10:55:19 +0100
Subject: [PATCH] docs: small tweaks to simplify/clarify docs (#260)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Clément Ollivier <clement.o2p@gmail.com>
Co-authored-by: pooya parsa <pyapar@gmail.com>
---
 docs/content/en/2.components/1.nuxt-img.md | 6 ++++--
 docs/content/en/3.api/1.options.md         | 3 ++-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/content/en/2.components/1.nuxt-img.md b/docs/content/en/2.components/1.nuxt-img.md
index f9ccbc7f8..11aacf61b 100644
--- a/docs/content/en/2.components/1.nuxt-img.md
+++ b/docs/content/en/2.components/1.nuxt-img.md
@@ -48,7 +48,9 @@ Specify width/height of the image.
 
 ### `sizes`
 
-Specify responsive reiszes.
+Specify responsive sizes.
+
+This a space-separated list of screen size/width pairs. You can [see a list of the defined screen sizes here](/api/options#screens)).
 
 **Example:**
 
@@ -109,7 +111,7 @@ Presets are predefined sets of image modifiers that can be used create unified f
 
 ```html
 <template>
-  <nuxt-img preset="jpg-cover" src="/nuxt-icon.png" width="50" height="50" />
+  <nuxt-img preset="cover" src="/nuxt-icon.png" />
 </template>
 ```
 
diff --git a/docs/content/en/3.api/1.options.md b/docs/content/en/3.api/1.options.md
index e5baa1852..924e0f14f 100644
--- a/docs/content/en/3.api/1.options.md
+++ b/docs/content/en/3.api/1.options.md
@@ -19,11 +19,12 @@ export default {
 
 List of predefined screen sizes.
 
-These sizes will be used to generate resized and optimized versions of an image.
+These sizes will be used to generate resized and optimized versions of an image (for example, with the `sizes` modifier).
 
 ```ts [nuxt.config.js]
 export default {
   image: {
+    // The screen sizes predefined by `@nuxt/image`:
     screens: {
       xs: 320,
       sm: 640,