Updated readme seo and aeo

[ashutoshkhainar33-star]

moodle-tiny_fastpix - Documentation PR

Scope: content/SEO-AEO + onboarding only. No code was changed - the single short-code block is byte-for-byte identical (same hash). Changes are prose/structure for a first-time author: badges, a "Works with" line, CTAs, a "no keys needed" note, an FAQ, a Troubleshooting section, and a FastPix Moodle suite table. Ten pre-existing prose em dashes were converted to hyphens (team zero-em-dash rule).

Documentation Changes

What Changed

• New documentation added
• Existing documentation updated
• Documentation errors fixed (10 em dashes -> hyphens, per the zero-em-dash rule)
• Code examples updated
• Links and references updated
• Other

Files Modified

• README.md
• Other: _______________

Summary

Brief description of changes:

Optimized the README's prose for search, AI discoverability, and first-time onboarding,
written for a teacher/author. No code was changed.
Added:

Static badges (Moodle 4.5+, PHP 8.1+, TinyMCE, GPL-3.0). No version badge - the release

could not be confirmed this run and the rule forbids inventing one.
A "Works with" line and picker-guide / free-account CTAs
A "No FastPix keys needed in this plugin" note (credentials live in local_fastpix)
A "The FastPix Moodle suite" table (local_fastpix, mod_fastpix, filter_fastpix) with

install order - all verified to exist
A 9-question FAQ (what it is / prerequisites, how to insert, no keys, missing button,

short code shows as text, which videos appear, uploading, other editors, versions)
A Troubleshooting section (button missing, short code shows as text, empty picker,

install refused)

Fixed:

Converted 10 pre-existing em dashes in prose to hyphens (the team enforces zero em dashes)

The existing (well-written) prose was preserved, not rewritten. The single short-code

block is byte-for-byte identical.

Code Examples (if Applicable)

N/A - the only code block (the {fastpix:pb_...} short code) was preserved exactly,
verified byte-for-byte by hashing. No code added.

Testing

• All code examples tested — N/A (no code examples changed)
• Links verified
• Grammar checked
• Formatting consistent
• Zero em dashes (team rule)

Review Checklist

• Content is accurate
• Code examples work — N/A (no code changed)
• Links are working
• Grammar is correct
• Formatting is consistent

SEO/AEO eval

Score: 8/8 Present. About, Topics, and Website have been applied on the repo, and the release (v1.1.0) is confirmed; this PR covers badges, the landing-page structure, interlinks, FAQ, and Troubleshooting. All correctness and onboarding gates pass; the single code block is byte-for-byte identical.

| Criterion | Result

-- | -- | --
1 | Repo name optimized | ✅ moodle-tiny_fastpix (Moodle convention; keep)
2 | About keywords | ✅ applied on repo (keyword-rich)
3 | Badges (Moodle, PHP, TinyMCE, GPL-3.0) | ✅ added in this PR (static). Release now confirmed as v1.1.0 - a version badge can be added if wanted
4 | README descriptive (new-author landing page) | ✅ added in this PR
5 | GitHub topics (11) | ✅ applied on repo
6 | Interlinks (3 sibling plugins + org, verified) | ✅ added in this PR
7 | Releases + package | ✅ 2 GitHub releases (latest v1.1.0) + Moodle Plugins directory
8 | FAQ (9 questions) | ✅ added in this PR

Onboarding gate: success moment defined (button appears + inserts a rendering short code), first-success workflow present (the 30-second tour), verification covered (FAQ + Troubleshooting), and no FastPix keys are needed in this plugin (clarified).

Gates: no code edited/added (short-code block preserved, same hash), no fabricated repos (all 3 sibling plugins verified live), no fabricated version, zero em dashes, links resolve.

Already applied on the repo (not part of this PR): About description, 11 Topics, and the Website field are live; release v1.1.0 is confirmed.

Only remaining step: land this README PR. Optional: now that the release is confirmed as v1.1.0, a version badge can be added to the README - say the word and I will add it.

---

Ready for review!