Consolidate WordPress.org assets into .wordpress-org directory

.wordpress-org/README.md

@@ -2,14 +2,16 @@
 
 This directory contains assets specific to the WordPress.org plugin repository and is used for automatic deployment via GitHub Actions.
 
-## Directory Contents
+## Directory Structure
 
-- `icon.svg` - Plugin icon displayed in the WordPress.org plugin directory
+```
-- `banner-772x250.png` - Standard banner for plugin header
+/assets/
-- `banner-1544x500.png` - Retina banner for plugin header
+    icon-256x256.png
-- `screenshot-1.png` - First screenshot displayed on plugin page
+    icon-128x128.png
-- `screenshot-2.png` - Second screenshot displayed on plugin page
+    banner-772x250.png
-- `screenshot-3.png` - Third screenshot displayed on plugin page
+    banner-1544x500.png
+    screenshot-1.png
+```
 
 ## Purpose
 
@@ -17,4 +19,21 @@ When using GitHub Actions for WordPress.org plugin deployments (via the 10up Wor
 
 ## Naming Conventions
 
-Files must be named exactly as shown above to be properly recognized by the WordPress.org system during the deployment process. 
+Files must be named exactly as shown above to be properly recognized by the WordPress.org system during the deployment process.
+
+## Right-to-Left (RTL) Support
+
+For plugins that support Right-to-Left languages (like Hebrew and Arabic), you can provide RTL versions of assets by appending `-rtl` to the filename:
+
+- `banner-772x250-rtl.png`
+- `banner-1544x500-rtl.png`
+- `icon-256x256-rtl.png`
+
+Note that the `-rtl` suffix is specifically for Right-to-Left language support, not for dark mode versions of assets.
+
+## Additional Resources
+
+For more detailed information about WordPress.org plugin assets, please see:
+
+- [WordPress Plugin Developer Handbook - Plugin Assets](https://developer.wordpress.org/plugins/wordpress-org/plugin-assets/)
+- [WordPress Plugin Directory README.txt Standard](https://developer.wordpress.org/plugins/wordpress-org/how-your-readme-txt-works/)