Rewrite the README and sync the composer description

README.md

@@ -1,20 +1,42 @@
-phpbb-3.1-annualstars
-=========================
+# Annual Stars
 
-Extension will display stars for the number of years a user has been registered on a forum.
+[![Tests](https://github.com/phpbbmodders/phpbb-3.1-annualstars/actions/workflows/tests.yml/badge.svg)](https://github.com/phpbbmodders/phpbb-3.1-annualstars/actions/workflows/tests.yml) [![Lint](https://github.com/phpbbmodders/phpbb-3.1-annualstars/actions/workflows/lint.yml/badge.svg)](https://github.com/phpbbmodders/phpbb-3.1-annualstars/actions/workflows/lint.yml)
 
-This extension is the 3.1.x version of the 3.0.x Annual Stars Mod](https://www.phpbb.com/customise/db/mod/annual_stars_2/)
+Shows a star for each year a member has been registered, on their posts and profile.
+
+## Features
+
+- One star per full year of membership, next to each post and on the member's profile.
+- Hovering a star shows "N years of membership".
+- No settings.
+
+## Requirements
+
+- phpBB 3.3.19 or later
+- PHP 7.4 or later
 
 ## Installation
 
-### 1. clone
-Clone (or download and move) the repository into the folder ext/phpbbmodders/annualstars:
+1. Copy the extension to `/ext/phpbbmodders/annualstars`
+2. In the Administration Control Panel, go to **Customise → Manage extensions**
+3. Enable the **Annual Stars** extension
+
+## Contributing
+
+Contributions are welcome!
+
+- **Bug reports**: [Open an issue](https://github.com/phpbbmodders/phpbb-3.1-annualstars/issues).
+- **Everything else** (questions, feature requests, ideas, general discussion): [Use Discussions](https://github.com/orgs/phpbbmodders/discussions), or the [community forum](https://www.phpbbmodders.com/community/).
+- Pull requests are welcome for bug fixes or discussed features.
+
+## Acknowledgments
+
+- Based on the phpBB 3.0 **Annual Stars** MOD by phpbbmodders.net (co-authors Kailey and bonelifer; contributors RMcGirr83, Sniper_E, igorw and tumba25).
+- Ported to phpBB 3.1 by Rich McGirr ([RMcGirr83](https://github.com/rmcgirr83)).
+- Code review, bug fixes, and documentation assisted by [Claude](https://www.anthropic.com/claude).
 
-```
-cd phpBB3
-git clone https://github.com/phpbbmodders/phpbb-3.1-annualstars.git ext/phpbbmodders/annualstars/
-```
+## License
 
-### 2. activate
-Go to admin panel -> tab customise -> Manage extensions -> enable Annual Stars
+This extension is licensed under the **GNU General Public License v2.0**.
 
+See [license.txt](license.txt) for more information.

composer.json

@@ -1,7 +1,7 @@
 {
 	"name": "phpbbmodders/annualstars",
 	"type": "phpbb-extension",
-	"description": "Displays stars based on a users registration date",
+	"description": "Shows a star for each year a member has been registered, on their posts and profile.",
 	"homepage": "https://www.phpbbmodders.com/",
 	"version": "1.0.2",
 	"time": "2017-02-14",