Docs Contributing Guide

.distignore

@@ -21,6 +21,7 @@ vendor/*
 .vibe/*
 AGENTS.md
 CLAUDE.md
+CONTRIBUTING.md
 README.md
 dev.md
 docs/*

.gitattributes

@@ -23,6 +23,7 @@ docs export-ignore
 
 AGENTS.md export-ignore
 CLAUDE.md export-ignore
+CONTRIBUTING.md export-ignore
 README.md export-ignore
 dev.md export-ignore
 

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to Warder Cookie Consent are documented here.
 
+## [2.1.2] - 2026-05-30
+
+### Documentation
+- Added `CONTRIBUTING.md` at the repository root covering build-from-source, development setup, dependencies, and how to submit changes.
+- Trimmed the developer-facing "Build from Source", "Development", and "Dependencies" sections out of the README and replaced them with a "Contributing" pointer to `CONTRIBUTING.md` and `docs/dev.md`. Renumbered the Composer install method accordingly.
+
 ## [2.1.1] - 2026-05-30
 
 ### Changed

CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to Warder Cookie Consent
+
+Thanks for your interest in improving Warder Cookie Consent! This guide covers how to
+build the plugin from source, set up a development environment, and submit changes.
+
+For a deeper technical reference on how the plugin loads settings, blocks scripts, and
+manages cookies, see [`docs/dev.md`](docs/dev.md).
+
+## Build from Source
+
+1. Clone this repository
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Build the plugin:
+   ```bash
+   npx webpack
+   ```
+4. Upload the plugin folder to your WordPress plugins directory
+
+## Development
+
+PHP 8.0+ is required. To set up the development environment:
+
+```bash
+# Install dependencies
+npm install
+
+# Build for production
+npx webpack
+
+# Watch for changes
+npx webpack --watch
+```
+
+The frontend bundle is built from `src/index.js` into `dist/cookieconsent.bundle.js`.
+There are no automated tests.
+
+## Dependencies
+
+- [CookieConsent v3](https://github.com/orestbida/cookieconsent) - Core cookie consent functionality
+- [webpack](https://webpack.js.org/) - For bundling assets
+- [style-loader](https://webpack.js.org/loaders/style-loader/) - For loading CSS
+- [css-loader](https://webpack.js.org/loaders/css-loader/) - For processing CSS
+
+## Submitting Changes
+
+1. Fork the repository and create a feature branch off `main`.
+2. Make your changes and rebuild the bundle (`npx webpack`) if you touched anything under `src/`.
+3. Open a pull request against `main` with a clear description of what changed and why.

README.md

@@ -29,20 +29,7 @@ A lightweight plugin that implements GDPR-compliant cookie consent functionality
 3. Upload the extracted folder to your `/wp-content/plugins/` directory
 4. Activate the plugin through the WordPress admin panel
 
-### Method 3: Build from Source
-
-1. Clone this repository
-2. Install dependencies:
-   ```bash
-   npm install
-   ```
-3. Build the plugin:
-   ```bash
-   npx webpack
-   ```
-4. Upload the plugin folder to your WordPress plugins directory
-
-### Method 4: Using Composer
+### Method 3: Using Composer
 
 You can also install the plugin using Composer:
 ```bash
@@ -155,27 +142,11 @@ The plugin automatically handles third-party cookies by:
 
 For detailed implementation guides, see [`docs/dev.md`](docs/dev.md).
 
-## Dependencies
-
-- [CookieConsent v3](https://github.com/orestbida/cookieconsent) - Core cookie consent functionality
-- [webpack](https://webpack.js.org/) - For bundling assets
-- [style-loader](https://webpack.js.org/loaders/style-loader/) - For loading CSS
-- [css-loader](https://webpack.js.org/loaders/css-loader/) - For processing CSS
-
-## Development
-
-To set up the development environment:
+## Contributing
 
-```bash
-# Install dependencies
-npm install
-
-# Build for production
-npx webpack
-
-# Watch for changes
-npx webpack --watch
-```
+Want to build from source, set up a development environment, or submit changes? See
+[`CONTRIBUTING.md`](CONTRIBUTING.md). For a deeper technical reference, see
+[`docs/dev.md`](docs/dev.md).
 
 ## License
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "imwz-cookie-consent",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "main": "webpack.config.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"

readme.txt

@@ -4,7 +4,7 @@ Donate link: https://imagewize.com
 Tags: cookie, consent, gdpr, privacy, compliance
 Requires at least: 5.0
 Tested up to: 7.0
-Stable tag: 2.1.1
+Stable tag: 2.1.2
 Requires PHP: 8.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -66,6 +66,12 @@ https://github.com/imagewize/warder-cookie-consent
 
 == Changelog ==
 
+= 2.1.2 =
+*2026-05-30*
+
+* Docs: added `CONTRIBUTING.md` at the repository root with build-from-source, development setup, dependencies, and contribution guidelines.
+* Docs: moved the developer-facing build/development/dependencies sections out of the README into `CONTRIBUTING.md`, leaving a short "Contributing" pointer; renumbered the Composer install method.
+
 = 2.1.1 =
 *2026-05-30*
 
@@ -207,6 +213,9 @@ https://github.com/imagewize/warder-cookie-consent
 
 == Upgrade Notice ==
 
+= 2.1.2 =
+Documentation-only release: adds a `CONTRIBUTING.md` and slims the README to user-facing docs. No functional changes.
+
 = 2.1.1 =
 Removes Slimstat from the default automatic script-blocking list (use the `warder_blocked_scripts` filter to add it back if needed). README updated to document WooCommerce cookie defaults and script-blocking examples.
 

warder-cookie-consent.php

@@ -2,7 +2,7 @@
 /**
  * Plugin Name: Warder Cookie Consent
  * Description: GDPR-compliant cookie consent banner with category management and floating preferences toggle.
- * Version: 2.1.1
+ * Version: 2.1.2
  * Author: Jasper Frumau
  * Author URI: https://imagewize.com
  * Requires at least: 5.0
@@ -16,7 +16,7 @@
 
 defined( 'ABSPATH' ) || exit;
 
-define( 'WARDER_VERSION', '2.1.1' );
+define( 'WARDER_VERSION', '2.1.2' );
 define( 'WARDER_PLUGIN_FILE', __FILE__ );
 
 require_once plugin_dir_path( __FILE__ ) . 'inc/defaults.php';