Update documentation for the image keyphrase assessment

[hdvos]

• I've read and understood the contribution guidelines.
• I've searched for any related issues and avoided creating a duplicate issue.

Please give us a description of what happened

The Keyphrase Image Assessment gives the incorrect feedback.

• with 5 images, and 4 (80%) of the images having the keyphrase in the alt-text, you should get the following feedback
  • Image Keyphrase: Out of 5 images on this page, 4 have alt attributes with words from your keyphrase or synonyms. That’s a bit much. Only include the focus keyphrase when it really fits the image.
• But you get the following feedback
  • Image Keyphrase: Good job!

See documentation.

⚠️ We found the documentation is actually incomplete here, so please adapt the documentation instead of attempting to solve it in the code 😅

With 5 out of 6 it seems to work.

To Reproduce

Step-by-step reproduction instructions

1. Create a Post
2. Add a focus keyphrase (for example Gustav Mahler)
3. Add 5 images.
4. 4 images should have Gustav Mahler in the alt-text
5. 1 image should have an alt-text without Gustav Mahler
6. Observe the behaviour described above

Expected results

1. The Keyphrase Image assessment should give the following feedback: Image Keyphrase: Out of 5 images on this page, 4 have alt attributes with words from your keyphrase or synonyms. That’s a bit much. Only include the focus keyphrase when it really fits the image.

Actual results

1. The Keyphrase Image assessment gives the following feedback Image Keyphrase: Good job!

Screenshots, screen recording, code snippet

If possible, please provide a screenshot, a screen recording or a code snippet which demonstrates the bug.

Technical info

• If relevant, which editor is affected (or editors):

• Block Editor
• Gutenberg Editor
• Elementor Editor
• Classic Editor
• Other:

• Which browser is affected (or browsers):

• Chrome
• Firefox
• Safari
• Other:

Used versions

• Device you are using:
• Operating system:
• PHP version:
• WordPress version:
• WordPress Theme:
• Yoast SEO version:
• Gutenberg plugin version:
• Elementor plugin version:
• Classic Editor plugin version:
• Relevant plugins in case of a bug:

[mhkuu]

Conclusion as per this Slack thread: we need to adapt the documentation here. I'll move this to our board!

[marinakoleva]

One more feedback string should be adjusted for the condition No images with keyphrase/synonym in alt-tags:

• In the documentation:
  Image Keyphrase: Images on this page do not have alt attributes with at least half of the words from your keyphrase. Fix that!
• In the browser:
  Image Keyphrase: Images on this page do not have alt attributes that reflect the topic of your text. Add your keyphrase or synonyms to the alt tags of relevant images!

[marinakoleva]

Also, the documentation states in the When it applies section that it applies: If there is a text. Does not apply to taxonomies., but actually there should also be at least one image present, right?

[mhkuu]

That's correct, there needs to be at least one image present.