WhoKnew Directory SEO™ | Readme History

Skip to main content
Table of Contents
Print

Readme History is a Wayback Machine for your plugin’s readme.txt. Every time you run a Readme Optimizer analysis and the readme version or content has changed, WhoKnew Directory SEO™ saves an automatic snapshot. You can browse the timeline and compare any two versions with a visual diff.

Where It Lives

The Readme History panel appears at the bottom of the Readme Optimizer tab, below the analysis card. Run at least one analysis to begin tracking changes. The panel header reads “A Wayback Machine for your readme — auto-saved on every analysis when version or content changes.”

How Snapshots Work

A snapshot is saved automatically after each analysis, but only when something has actually changed. Specifically, WhoKnew™ compares the current readme’s:

  • Stable tag version — if the version number in your readme header changed, a new snapshot is saved.
  • Content hash — if the readme text itself changed (even without a version bump), a new snapshot is saved.

If neither the version nor the content hash has changed since the last snapshot, no duplicate is created. Each plugin has a separate history stored independently.

✅ No credits used: Saving and browsing readme snapshots is entirely free. Snapshots are stored in your WordPress database and don’t require any API calls to view.

Snapshot Limit

WhoKnew Directory SEO™ stores up to 30 snapshots per plugin. The panel badge shows “Up to 30 snapshots per plugin.” When the limit is reached, the oldest snapshot is automatically removed to make room for a new one.

Viewing the Visual Diff

  1. In the Readme History panel, click any snapshot in the timeline list.
  2. The diff panel slides in, showing a line-by-line comparison between that snapshot and the current readme. Added lines are highlighted in green; removed lines in red.
  3. Click ← Back to timeline to return to the snapshot list.

Deleting Snapshots

Individual snapshots can be deleted from the timeline list. This is useful if you saved a snapshot from a test run or an outdated draft. Deletion is immediate and cannot be undone.

Need Help?

For the main Readme Optimizer walkthrough, see The Readme Optimizer. If your readme isn’t auto-loading into the analysis form, see Readme Not Loading. For the AI prompt generator, see AI Readme Optimizer.

Share