Split up extensions in Explore between official and community (#1996)

* Split up extensions in Explore between official and community

* Update extension-registry-changed script

Update script so it creates two separate lists for the Official and Community extensions

* Fix nav-cards element

* Fix extension-registry-changed script

Update section that replaces list of extensions

* Fix explore.md extension order

* Fix readlink issue

* Apply to previous versions

* Apply suggestions from code review

Co-authored-by: Jack Baldry <[email protected]>

* Update docs/sources/k6/next/extensions/explore.md

---------

Co-authored-by: Jack Baldry <[email protected]>

Author: heitortsergent

docs/sources/k6/next/extensions/explore.md

@@ -30,6 +30,66 @@ docker run --rm -u "$(id -u):$(id -g)" -v "${PWD}:/xk6" grafana/xk6 build \
 
 Use the table to explore the many extensions. Questions? Feel free to join the discussion about extensions in the [k6 Community Forum](https://community.grafana.com/c/grafana-k6/extensions/82).
 
+## Official extensions
+
+These are the official extensions, which are owned and maintained by the Grafana organization.
+
+<div class="nav-cards">
+    <a href="https://github.com/grafana/xk6-client-prometheus-remote" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-client-prometheus-remote</h4>
+        <p>Test Prometheus Remote Write-compatible endpoints</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-dashboard" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-dashboard</h4>
+        <p>Create a web-based metrics dashboard</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-disruptor" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-disruptor</h4>
+        <p>Inject faults to test 💣</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-exec" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-exec</h4>
+        <p>Run external commands</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-faker" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-faker</h4>
+        <p>Generate fake data in your tests</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-kubernetes" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-kubernetes</h4>
+        <p>Interact with Kubernetes clusters</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-output-influxdb" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-output-influxdb</h4>
+        <p>Export results to InfluxDB v2</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-sql" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-sql</h4>
+        <p>Load-test SQL Servers</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-sql-driver-mysql" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-sql-driver-mysql</h4>
+        <p>xk6-sql driver extension for MySQL database support</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-sql-driver-postgres" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-sql-driver-postgres</h4>
+        <p>xk6-sql driver extension for Postgres database support</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-sql-driver-sqlite3" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-sql-driver-sqlite3</h4>
+        <p>xk6-sql driver extension for SQLite v3 database support</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-ssh" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-ssh</h4>
+        <p>Use SSH connections in your tests</p>
+    </a>
+</div>
+
+## Community extensions
+
+These are the community extensions, which are owned by our community members.
+The Grafana team makes a best-effort assistance to keep these extensions in compliance.
+
 <div class="nav-cards">
     <a href="https://github.com/prmuthu/xk6-amqp" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-amqp</h4>
@@ -51,10 +111,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-cache</h4>
         <p>Enable vendoring remote HTTP modules to a single source-control-friendly file</p>
     </a>
-    <a href="https://github.com/grafana/xk6-client-prometheus-remote" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-client-prometheus-remote</h4>
-        <p>Test Prometheus Remote Write-compatible endpoints</p>
-    </a>
     <a href="https://github.com/grafana/xk6-client-tracing" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-client-tracing</h4>
         <p>Client for load testing distributed tracing backends</p>
@@ -79,14 +135,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-csv</h4>
         <p>Parse CSV values</p>
     </a>
-    <a href="https://github.com/grafana/xk6-dashboard" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-dashboard</h4>
-        <p>Create a web-based metrics dashboard</p>
-    </a>
-    <a href="https://github.com/grafana/xk6-disruptor" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-disruptor</h4>
-        <p>Inject faults to test 💣</p>
-    </a>
     <a href="https://github.com/szkiba/xk6-dotenv" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-dotenv</h4>
         <p>Load env vars from a .env file</p>
@@ -95,14 +143,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-ethereum</h4>
         <p>K6 extension for ethereum protocols</p>
     </a>
-    <a href="https://github.com/grafana/xk6-exec" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-exec</h4>
-        <p>Run external commands</p>
-    </a>
-    <a href="https://github.com/grafana/xk6-faker" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-faker</h4>
-        <p>Generate fake data in your tests</p>
-    </a>
     <a href="https://github.com/domsolutions/xk6-fasthttp" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-fasthttp</h4>
         <p>Enable RPS increase & file streaming on HTTP/1.1 requests</p>
@@ -139,10 +179,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-kafka</h4>
         <p>Load test Apache Kafka. Includes support for Avro messages.</p>
     </a>
-    <a href="https://github.com/grafana/xk6-kubernetes" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-kubernetes</h4>
-        <p>Interact with Kubernetes clusters</p>
-    </a>
     <a href="https://github.com/oleiade/xk6-kv" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-kv</h4>
         <p>Share key-value data between VUs</p>
@@ -183,10 +219,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-output-elasticsearch</h4>
         <p>Export results to Elasticsearch 8.x</p>
     </a>
-    <a href="https://github.com/grafana/xk6-output-influxdb" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-output-influxdb</h4>
-        <p>Export results to InfluxDB v2</p>
-    </a>
     <a href="https://github.com/grafana/xk6-output-kafka" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-output-kafka</h4>
         <p>Export k6 results in real-time to Kafka</p>
@@ -247,10 +279,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-smtp</h4>
         <p>Use SMTP protocol to send emails</p>
     </a>
-    <a href="https://github.com/grafana/xk6-sql" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-sql</h4>
-        <p>Load-test SQL Servers</p>
-    </a>
     <a href="https://github.com/grafana/xk6-sql-driver-azuresql" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-sql-driver-azuresql</h4>
         <p>xk6-sql driver extension for Microsoft Azure SQL database support</p>
@@ -259,22 +287,10 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-sql-driver-clickhouse</h4>
         <p>xk6-sql driver extension for ClickHouse database support</p>
     </a>
-    <a href="https://github.com/grafana/xk6-sql-driver-mysql" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-sql-driver-mysql</h4>
-        <p>xk6-sql driver extension for MySQL database support</p>
-    </a>
-    <a href="https://github.com/grafana/xk6-sql-driver-postgres" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-sql-driver-postgres</h4>
-        <p>xk6-sql driver extension for Postgres database support</p>
-    </a>
     <a href="https://github.com/grafana/xk6-sql-driver-ramsql" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-sql-driver-ramsql</h4>
         <p>xk6-sql driver extension for RamSQL database support</p>
     </a>
-    <a href="https://github.com/grafana/xk6-sql-driver-sqlite3" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-sql-driver-sqlite3</h4>
-        <p>xk6-sql driver extension for SQLite v3 database support</p>
-    </a>
     <a href="https://github.com/grafana/xk6-sql-driver-sqlserver" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-sql-driver-sqlserver</h4>
         <p>xk6-sql driver extension for Microsoft SQL Server database support</p>
@@ -283,10 +299,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-sse</h4>
         <p>Server Sent Event</p>
     </a>
-    <a href="https://github.com/grafana/xk6-ssh" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-ssh</h4>
-        <p>Use SSH connections in your tests</p>
-    </a>
     <a href="https://github.com/walterwanderley/xk6-stomp" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-stomp</h4>
         <p>Client for STOMP protocol</p>

docs/sources/k6/v1.0.x/extensions/explore.md

@@ -30,7 +30,71 @@ docker run --rm -u "$(id -u):$(id -g)" -v "${PWD}:/xk6" grafana/xk6 build \
 
 Use the table to explore the many extensions. Questions? Feel free to join the discussion about extensions in the [k6 Community Forum](https://community.grafana.com/c/grafana-k6/extensions/82).
 
+## Official extensions
+
+These are the official extensions, which are owned and maintained by the Grafana organization.
+
 <div class="nav-cards">
+    <a href="https://github.com/grafana/xk6-client-prometheus-remote" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-client-prometheus-remote</h4>
+        <p>Test Prometheus Remote Write-compatible endpoints</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-dashboard" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-dashboard</h4>
+        <p>Create a web-based metrics dashboard</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-disruptor" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-disruptor</h4>
+        <p>Inject faults to test 💣</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-exec" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-exec</h4>
+        <p>Run external commands</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-faker" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-faker</h4>
+        <p>Generate fake data in your tests</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-kubernetes" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-kubernetes</h4>
+        <p>Interact with Kubernetes clusters</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-output-influxdb" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-output-influxdb</h4>
+        <p>Export results to InfluxDB v2</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-sql" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-sql</h4>
+        <p>Load-test SQL Servers</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-sql-driver-mysql" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-sql-driver-mysql</h4>
+        <p>xk6-sql driver extension for MySQL database support</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-sql-driver-postgres" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-sql-driver-postgres</h4>
+        <p>xk6-sql driver extension for Postgres database support</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-sql-driver-sqlite3" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-sql-driver-sqlite3</h4>
+        <p>xk6-sql driver extension for SQLite v3 database support</p>
+    </a>
+    <a href="https://github.com/grafana/xk6-ssh" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-ssh</h4>
+        <p>Use SSH connections in your tests</p>
+    </a>
+</div>
+
+## Community extensions
+
+These are the community extensions, which are owned by our community members.
+The Grafana team makes a best-effort assistance to keep these extensions in compliance.
+
+<div class="nav-cards">
+    <a href="https://github.com/prmuthu/xk6-amqp" target="_blank" class="nav-cards__item nav-cards__item--guide">
+        <h4>xk6-amqp</h4>
+        <p>To publish and consume messages using AMQP protocol</p>
+    </a>
     <a href="https://github.com/szkiba/xk6-ansible-vault" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-ansible-vault</h4>
         <p>Encrypt and decrypt Ansible Vault</p>
@@ -47,10 +111,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-cache</h4>
         <p>Enable vendoring remote HTTP modules to a single source-control-friendly file</p>
     </a>
-    <a href="https://github.com/grafana/xk6-client-prometheus-remote" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-client-prometheus-remote</h4>
-        <p>Test Prometheus Remote Write-compatible endpoints</p>
-    </a>
     <a href="https://github.com/grafana/xk6-client-tracing" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-client-tracing</h4>
         <p>Client for load testing distributed tracing backends</p>
@@ -75,14 +135,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-csv</h4>
         <p>Parse CSV values</p>
     </a>
-    <a href="https://github.com/grafana/xk6-dashboard" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-dashboard</h4>
-        <p>Create a web-based metrics dashboard</p>
-    </a>
-    <a href="https://github.com/grafana/xk6-disruptor" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-disruptor</h4>
-        <p>Inject faults to test 💣</p>
-    </a>
     <a href="https://github.com/szkiba/xk6-dotenv" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-dotenv</h4>
         <p>Load env vars from a .env file</p>
@@ -91,14 +143,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-ethereum</h4>
         <p>K6 extension for ethereum protocols</p>
     </a>
-    <a href="https://github.com/grafana/xk6-exec" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-exec</h4>
-        <p>Run external commands</p>
-    </a>
-    <a href="https://github.com/grafana/xk6-faker" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-faker</h4>
-        <p>Generate fake data in your tests</p>
-    </a>
     <a href="https://github.com/domsolutions/xk6-fasthttp" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-fasthttp</h4>
         <p>Enable RPS increase & file streaming on HTTP/1.1 requests</p>
@@ -135,10 +179,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-kafka</h4>
         <p>Load test Apache Kafka. Includes support for Avro messages.</p>
     </a>
-    <a href="https://github.com/grafana/xk6-kubernetes" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-kubernetes</h4>
-        <p>Interact with Kubernetes clusters</p>
-    </a>
     <a href="https://github.com/oleiade/xk6-kv" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-kv</h4>
         <p>Share key-value data between VUs</p>
@@ -163,10 +203,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-nostr</h4>
         <p>Interact with Nostr relays</p>
     </a>
-    <a href="https://github.com/grafana/xk6-notification" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-notification</h4>
-        <p>Create notifications</p>
-    </a>
     <a href="https://github.com/frankhefeng/xk6-oauth-pkce" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-oauth-pkce</h4>
         <p>Generate OAuth PKCE code verifier and code challenge</p>
@@ -183,10 +219,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-output-elasticsearch</h4>
         <p>Export results to Elasticsearch 8.x</p>
     </a>
-    <a href="https://github.com/grafana/xk6-output-influxdb" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-output-influxdb</h4>
-        <p>Export results to InfluxDB v2</p>
-    </a>
     <a href="https://github.com/grafana/xk6-output-kafka" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-output-kafka</h4>
         <p>Export k6 results in real-time to Kafka</p>
@@ -247,10 +279,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-smtp</h4>
         <p>Use SMTP protocol to send emails</p>
     </a>
-    <a href="https://github.com/grafana/xk6-sql" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-sql</h4>
-        <p>Load-test SQL Servers</p>
-    </a>
     <a href="https://github.com/grafana/xk6-sql-driver-azuresql" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-sql-driver-azuresql</h4>
         <p>xk6-sql driver extension for Microsoft Azure SQL database support</p>
@@ -259,22 +287,10 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-sql-driver-clickhouse</h4>
         <p>xk6-sql driver extension for ClickHouse database support</p>
     </a>
-    <a href="https://github.com/grafana/xk6-sql-driver-mysql" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-sql-driver-mysql</h4>
-        <p>xk6-sql driver extension for MySQL database support</p>
-    </a>
-    <a href="https://github.com/grafana/xk6-sql-driver-postgres" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-sql-driver-postgres</h4>
-        <p>xk6-sql driver extension for Postgres database support</p>
-    </a>
     <a href="https://github.com/grafana/xk6-sql-driver-ramsql" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-sql-driver-ramsql</h4>
         <p>xk6-sql driver extension for RamSQL database support</p>
     </a>
-    <a href="https://github.com/grafana/xk6-sql-driver-sqlite3" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-sql-driver-sqlite3</h4>
-        <p>xk6-sql driver extension for SQLite v3 database support</p>
-    </a>
     <a href="https://github.com/grafana/xk6-sql-driver-sqlserver" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-sql-driver-sqlserver</h4>
         <p>xk6-sql driver extension for Microsoft SQL Server database support</p>
@@ -283,10 +299,6 @@ Use the table to explore the many extensions. Questions? Feel free to join the d
         <h4>xk6-sse</h4>
         <p>Server Sent Event</p>
     </a>
-    <a href="https://github.com/grafana/xk6-ssh" target="_blank" class="nav-cards__item nav-cards__item--guide">
-        <h4>xk6-ssh</h4>
-        <p>Use SSH connections in your tests</p>
-    </a>
     <a href="https://github.com/walterwanderley/xk6-stomp" target="_blank" class="nav-cards__item nav-cards__item--guide">
         <h4>xk6-stomp</h4>
         <p>Client for STOMP protocol</p>