I believe a lintian patch like this might include the improvements suggested by Peter:
diff --git a/tags/a/appstream-metadata-validation-failed.tag b/tags/a/appstream-metadata-validation-failed.tag index 52d1be670..e45f8d009 100644 --- a/tags/a/appstream-metadata-validation-failed.tag +++ b/tags/a/appstream-metadata-validation-failed.tag @@ -2,5 +2,13 @@ Tag: appstream-metadata-validation-failed Severity: warning Check: appstream-metadata See-Also: https://wiki.debian.org/AppStream/Guidelines -Explanation: The specified AppStream metadata file fail to validate using - 'appstreamcli validate-tree --no-net path-to-package-root'. +Explanation: + The specified AppStream metadata file fail to validate using + 'appstreamcli validate-tree --no-net path-to-unpacked-binary-package-root'. + + The various issues with hints on solutions are described in + https://www.freedesktop.org/software/appstream/docs/chap-Validation.html. + + To reproduce for a given binary package foo.deb, run 'dpkg-deb -R + foo.deb /tmp/foo-unpacked && appstreamcli validate-tree --no-net + /tmp/foo-unpacked'. -- Happy hacking Petter Reinholdtsen