Add documentation for filter

Author: tijmenbruggeman

docs/hooks/index.md

@@ -0,0 +1,12 @@
+# Hooks
+
+The plugin provides several hooks to let you extend or modify its behavior.
+
+## Actions
+
+- [updated_tiny_postmeta](updated_tiny_postmeta.md) — Triggered when tinify meta data has been updated
+- [tiny_image_after_compression](tiny_image_after_compression.md) — Triggered after successful optimization.
+
+## Filters
+
+- [tiny_replace_with_picture](tiny_replace_with_picture.md) — Enable or disable converting `<img>` tags to `<picture>` elements.

docs/hooks/tiny_replace_with_picture.md

@@ -0,0 +1,27 @@
+# tiny_replace_with_picture
+
+Filter that allows you to skip converting page content `<img>` tags into `<picture>` elements. Returning `false` disables the feature completely for that request.
+The filter will fire on `init` with a default priority of `10`. Register your filter during or before `init` with a smaller priority than `10` to take effect.
+
+**Location:** `src/class-tiny-plugin.php`  
+**Since:** 3.7.0
+
+## Arguments
+
+1. `bool $should_replace` — boolean to control wether `<img>` elements on the page should be replaced by `<picture>` elements if they have an optimized version. Defaults to true. Return `false` to skip all `<picture>` replacements.
+
+## Example
+
+```php
+add_filter(
+	'tiny_replace_with_picture',
+	function ( $should_replace ) {
+		// Disable picture replacement on RSS feeds.
+		if ( is_feed() ) {
+			return false;
+		}
+
+		return $should_replace;
+	}
+);
+```

docs/index.md

@@ -0,0 +1,9 @@
+# Tinify WordPress — Documentation
+
+Welcome to the developer documentation of the Tinify WordPress plugin.
+
+## Sections
+
+- [Hooks](hooks/index.md)
+  - [Actions](hooks/index.md#actions)
+  - [Filters](filters/index.md#filters)