From df73737a7a8b018f2fb1dc78edb5934b581d954b Mon Sep 17 00:00:00 2001 From: skyace65 Date: Thu, 22 Jun 2023 20:01:36 -0400 Subject: [PATCH] Add compression guidelines to doc image guide --- contributing/documentation/docs_image_guidelines.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/contributing/documentation/docs_image_guidelines.rst b/contributing/documentation/docs_image_guidelines.rst index 35099531657..36002f8fff8 100644 --- a/contributing/documentation/docs_image_guidelines.rst +++ b/contributing/documentation/docs_image_guidelines.rst @@ -41,7 +41,11 @@ While some Linux programs will support saving screenshots in this format, macOS and the Snip & Sketch program on Windows do not. For images that don't need editing, such as precise cropping or adding outlines, Squoosh can be used. `Squoosh `_ is a converter developed by Google, is open -source, and doesn't give Google any image rights by using it. +source, and doesn't give Google any image rights by using it. When choosing +compression if you can get an image that's under 300KB in size use lossless +compression. If it's over 300KB use just enough lossy compression to get it +under that size. If this results in noticable compression artifacts using less +compression is fine, even if the file size is bigger. If you already have an image editor such as GIMP, Krita or Photoshop installed it may have the ability to open an image then save it as a WebP file. @@ -101,6 +105,11 @@ To save an image as webp if it isn't already one, Go to **File > Save As**. Sele will popup with webp options. Make sure **Losses** is checked and **Quality** is set to 100%. This means the image will not lose detail and will be as small as possible. +If the image is over 300KB in size try compressing it losslessly using `Squoosh `_. +If it's still over 300KB change to lossy compression and slowly increase the compression until it's under +300KB. If this results in noticable compression artifacts using less compression is fine, even if the file +size is bigger. + Outlines arrows and text ------------------------