```suggestion When finding cached icons, they must only be searched for in the same location where the accompanying catalog metadata is located. For example, icons for <filename>/var/lib/swcatalog/xml/debian-jessie-main.xml.gz</filename> must only be looked up in <filename>/var/lib/swcatalog/icons/debian-jessie-main/</filename> and not also in locations in <filename>/var/cache/</filename> or elsewhere. ``` Just a suggestion - I found the suggested sentence a bit confusing, because I don't know what it refers to without the context given by the GNOME Software bug report. Also, and example is always nice to have!

`/var/cache/` is still a valid location, so maybe change this to ```suggestion All icons of type <literal>cached</literal> must be placed in <filename>/usr/share/swcatalog/icons/%{origin}/%{size}/</filename> or <filename>/var/(lib|cache)/swcatalog/icons/%{origin}/%{size}/</filename>, ```