Improve documentation and prepare for WordPress.org submission (v2.0.1)

.gitattributes

@@ -4,32 +4,98 @@
 # Auto detect text files and perform LF normalization
 * text=auto
 
-# Text files that should be normalized
-*.php text
-*.css text
-*.js text
-*.htm text
-*.html text
-*.xml text
-*.txt text
-*.ini text
-*.inc text
-*.md text
-.htaccess text
+# Text files that should be normalized with LF line endings
+*.php text eol=lf
+*.css text eol=lf
+*.js text eol=lf
+*.scss text eol=lf
+*.htm text eol=lf
+*.html text eol=lf
+*.xml text eol=lf
+*.txt text eol=lf
+*.ini text eol=lf
+*.inc text eol=lf
+*.md text eol=lf
+*.json text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.po text eol=lf
+*.pot text eol=lf
+*.svg text eol=lf
+.htaccess text eol=lf
 
 # Files that should be treated as binary
 *.png binary
 *.jpg binary
+*.jpeg binary
 *.gif binary
 *.ico binary
+*.webp binary
 *.zip binary
 *.gz binary
 *.tar binary
 *.ttf binary
 *.eot binary
 *.woff binary
+*.woff2 binary
+*.pxd binary
+*.afdesign binary
+*.afphoto binary
+*.afpub binary
+
+# Exclude files from export (for WordPress.org SVN and distribution packages)
+.gitattributes export-ignore
+.gitignore export-ignore
+.github export-ignore
+.wordpress-org export-ignore
+README.md export-ignore
+CHANGELOG.md export-ignore
+composer.json export-ignore
+composer.lock export-ignore
+package.json export-ignore
+package-lock.json export-ignore
+phpcs.xml export-ignore
+.phpcs.xml export-ignore
+phpunit.xml export-ignore
+.phpunit.xml export-ignore
+.distignore export-ignore
+.editorconfig export-ignore
+.eslintrc export-ignore
+.eslintignore export-ignore
+.prettierrc export-ignore
+.prettierignore export-ignore
+.stylelintrc export-ignore
+.stylelintignore export-ignore
+.travis.yml export-ignore
+.gitlab-ci.yml export-ignore
+bitbucket-pipelines.yml export-ignore
+bin export-ignore
+tests export-ignore
+assets/icon/*.svg export-ignore
+assets/banner/*.svg export-ignore
+assets/screenshots/*.pxd export-ignore
+assets/icon/*.pxd export-ignore
+assets/banner/*.pxd export-ignore
+
+# AI assistant and workflow files
+.ai-assistant.md export-ignore
+.ai-workflows export-ignore
+.augmentignore export-ignore
+.cursorignore export-ignore
+.v0ignore export-ignore
+.clinerc export-ignore
+.continuerc export-ignore
+reference-plugins export-ignore
 
 # Set the default behavior for GitHub language detection
 *.css linguist-language=CSS
 *.js linguist-language=JavaScript
-*.php linguist-language=PHP
+*.php linguist-language=PHP
+*.scss linguist-language=SCSS
+*.pot linguist-language=Gettext Catalog
+*.po linguist-language=Gettext Catalog
+*.mo linguist-language=Gettext Catalog
+
+# Merge driver for changelog files to prevent conflicts
+CHANGELOG.md merge=union
+readme.txt merge=union