From 9153554c8eb9ce5b149f8e0056a6fd3eba0d986a Mon Sep 17 00:00:00 2001
From: lowlighter <22963968+lowlighter@users.noreply.github.com>
Date: Sat, 15 Jan 2022 21:19:55 -0500
Subject: [PATCH] doc(plugins/introduction): update

---
 source/plugins/introduction/README.md    | 43 ++++++++++++++----------
 source/plugins/introduction/metadata.yml |  7 ++++
 2 files changed, 32 insertions(+), 18 deletions(-)

diff --git a/source/plugins/introduction/README.md b/source/plugins/introduction/README.md
index 01856f26..41932f04 100644
--- a/source/plugins/introduction/README.md
+++ b/source/plugins/introduction/README.md
@@ -1,21 +1,30 @@
-### 🙋 Introduction
-
-The *introduction* plugin display your account bio or your organization/repository description.
-It is mostly intended for metrics used outside of GitHub, since these informations are already available on GitHub.
-
+<!--header-->
 <table>
-  <td align="center">
-    <details open><summary>For an user or an organization</summary>
-      <img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.introduction.svg">
-    </details>
-    <details><summary>For a repository</summary>
-      <img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.introduction.repository.svg">
-    </details>
-    <img width="900" height="1" alt="">
-  </td>
+  <tr><th colspan="2"><h3>🙋 Introduction</h3></th></tr>
+  <tr><td colspan="2" align="center"><p>This plugin displays account bio or organization/repository description.</p>
+<p>It is mostly intended for images that will be used outside of GitHub, since these informations are already displayed on GitHub.</p>
+</td></tr>
+  <tr>
+    <th rowspan="3">Supported features<br><sub><a href="metadata.yml">→ Full specification</a></sub></th>
+    <td><a href="/source/templates/classic"><code>📗 Classic template</code></a> <a href="/source/templates/repository"><code>📘 Repository template</code></a></td>
+  </tr>
+  <tr>
+    <td><code>👤 Users</code> <code>👥 Organizations</code> <code>📓 Repositories</code></td>
+  </tr>
+  <tr>
+    <td><code>🔑 (scopeless)</code> <code>read:org (optional)</code> <code>read:user (optional)</code> <code>repo (optional)</code></td>
+  </tr>
+  <tr>
+    <td colspan="2" align="center">
+      <details open><summary>For an user or an organization</summary><img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.introduction.svg" alt=""></img></details>
+      <details><summary>For a repository</summary><img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.introduction.repository.svg" alt=""></img></details>
+      <img width="900" height="1" alt="">
+    </td>
+  </tr>
 </table>
+<!--/header-->
 
-#### ➡️ Available options
+## ➡️ Available options
 
 <!--options-->
 <table>
@@ -45,9 +54,7 @@ It is mostly intended for metrics used outside of GitHub, since these informatio
 </table>
 <!--/options-->
 
-*[→ Full specification](metadata.yml)*
-
-#### ℹ️ Examples workflows
+## ℹ️ Examples workflows
 
 <!--examples-->
 ```yaml
diff --git a/source/plugins/introduction/metadata.yml b/source/plugins/introduction/metadata.yml
index 408f5331..b211c2af 100644
--- a/source/plugins/introduction/metadata.yml
+++ b/source/plugins/introduction/metadata.yml
@@ -1,5 +1,12 @@
 name: "🙋 Introduction"
 category: github
+description: |
+  This plugin displays account bio or organization/repository description.
+
+  It is mostly intended for images that will be used outside of GitHub, since these informations are already displayed on GitHub.
+examples:
+  +for an user or an organization: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.introduction.svg
+  for a repository: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.introduction.repository.svg
 index: 22
 supports:
   - user