Get it working hopefully on both GitHub + mkdocs

README.md

@@ -1,11 +1,5 @@
 # ![nf-validation](docs/images/nf-validation.svg)
 
-## 📚 Docs 👉🏻 <https://nextflow-io.github.io/nf-validation>
-
-!!! warning
-
-<div class="admonition warning" markdown>
-
 <!-- prettier-ignore -->
 > [!IMPORTANT]
 > **`nf-validation` has now been renamed to `nf-schema`. The `nf-validation` plugin will not receive any future updates.**
@@ -17,7 +11,7 @@
 > plugins { id '[email protected]' }
 > ```
 
-</div>
+## 📚 Docs 👉🏻 <https://nextflow-io.github.io/nf-validation>
 
 **A Nextflow plugin to work with validation of pipeline parameters and sample sheets.**
 

docs/index.md

@@ -11,4 +11,14 @@ description: Nextflow plugin for sample sheet validation
 
 ==}
 
---8<-- "README.md:6:"
+!!! warning "`nf-validation` has now been renamed to `nf-schema`."
+
+    **`nf-validation` has now been renamed to `nf-schema`. The `nf-validation` plugin will not receive any future updates.**
+    **Please update your pipelines to use [`nf-schema`](https://github.com/nextflow-io/nf-schema) instead.**
+    This change was necessary to prevent older versions of `nf-core` pipelines from with unpinned plugin references from breaking when updating to the latest version of `nf-validation`.
+    **Please pin the version of `nf-schema` in your pipeline's `nextflow.config` file:**
+    ```nextflow
+    plugins { id '[email protected]' }
+    ```
+
+--8<-- "README.md:18:"