add readme to explain how this directory is handled

Generated by cursor

Author: Omar-AlJaljuli

modules/extend_dynamic-plugins-reference/README.adoc

@@ -0,0 +1,52 @@
+= Dynamic plugins reference module
+
+Most of the reference content in this directory is not authored here. It is copied from the Red Hat Developer Hub (RHDH) plugin catalog index OCI image at build/sync time.
+
+== Files fetched from the plugin catalog index
+
+The script `rhdh-supported-plugins.sh` pulls pre-built documentation from the plugin catalog index image and copies these files into this directory:
+
+* `con-preinstalled-dynamic-plugins.adoc`
+* `ref-deprecated-plugins.adoc`
+* `ref-ga-plugins.adoc`
+* `ref-technology-preview-plugins.adoc`
+* `rhdh-supported-plugins.csv`
+
+The image is published at `quay.io/rhdh/plugin-catalog-index`. The tag is derived from the docs branch:
+
+* `release-1.10` → `1.10`
+* `main` → `next`
+
+Content is extracted from the `extend_dynamic-plugins-reference/` path inside the image.
+
+== Files maintained in this repository
+
+These files are not fetched from the catalog index:
+
+* `ref-community-supported-plugins.adoc` — generated by `rhdh-supported-plugins.sh` from https://github.com/redhat-developer/rhdh-plugin-export-overlays[redhat-developer/rhdh-plugin-export-overlays]
+* `ref-community-supported-plugins.template.adoc` — template used by the script above
+* `ref-other-installable-plugins.adoc` — hand-maintained reference
+* `snip-dynamic-plugins-configuring-note.adoc` — shared snippet
+* `rhdh-supported-plugins.sh` — sync script for this module
+* `README.adoc` — this file
+
+== Contributing to the dynamic plugins tables
+
+Do not edit the fetched files directly in this repository. Changes will be overwritten the next time the sync script or the automated workflow runs.
+
+To add or update Red Hat supported plugin tables (GA, Tech Preview, deprecated, preinstalled plugins, or the CSV), contribute in the *RHDH plugin catalog midstream repository*
+Replace `release-1.10` with the branch you are working on.
+
+To update only the community plugins table, changes belong in https://github.com/redhat-developer/rhdh-plugin-export-overlays[redhat-developer/rhdh-plugin-export-overlays] instead. Run the script with `--skip-tables` to regenerate only that file:
+
+== Automation
+
+The GitHub Actions workflow `.github/workflows/generate-supported-plugins-pr.yml` runs `rhdh-supported-plugins.sh` on a schedule and opens a pull request when the catalog index or overlays repo content changes.
+
+== Requirements
+
+Running the sync script locally requires:
+
+* `skopeo`
+* `jq`
+* `yq` (the https://kislyuk.github.io/yq/[kislyuk/jq-wrapper] version, not mikefarah/yq)