@@ -2,7 +2,18 @@
 
 [![Firefox Add-on](https://img.shields.io/amo/v/git-pr-reverse?logo=firefoxbrowser&label=Firefox%20Add-on)](https://addons.mozilla.org/firefox/addon/git-pr-reverse/)
 
-WebExtension to list open pull requests of a file.
+A browser WebExtension to list open pull requests of a file.
+
+## Overview
+
+When you browse a file on a supported forge, the extension:
+- shows the number of open pull requests that modify the current file (**toolbar
+  badge**);
+- lists those pull requests as direct links when you click the toolbar icon
+  (**popup**).
+
+This helps you spot pending changes before editing a file and avoid conflicting
+with work already in review.
 
 ## Supported forges