doc(plugins/achievements): update

source/plugins/achievements/README.md

@@ -1,33 +1,29 @@
-### 🏆 Achievements
+<!--header-->
-
-The *achievements* plugin displays several highlights about what you achieved on GitHub.
-
 <table>
-  <td align="center">
+  <tr><th colspan="2"><h3>🏆 Achievements</h3></th></tr>
-    <details open><summary>Compact display</summary>
+  <tr><td colspan="2" align="center"><p>This plugin displays several highlights about what you achieved on GitHub.</p>
-      <img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.achievements.compact.svg">
+</td></tr>
-    </details>
+  <tr>
-    <details><summary>Detailed display</summary>
+    <th rowspan="3">Supported features<br><sub><a href="metadata.yml">→ Full specification</a></sub></th>
-      <img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.achievements.svg">
+    <td><a href="/source/templates/classic"><code>📗 Classic template</code></a></td>
-    </details>
+  </tr>
+  <tr>
+    <td><code>👤 Users</code> <code>👥 Organizations</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>Compact display</summary><img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.achievements.compact.svg" alt=""></img></details>
+      <details><summary>Detailed display</summary><img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.achievements.svg" alt=""></img></details>
       <img width="900" height="1" alt="">
     </td>
+  </tr>
 </table>
+<!--/header-->
 
-Achievements are mostly related to features offered by GitHub, so by unlocking achivements ranks you'll be mastering GitHub in no time!
+## ➡️ Available options
-
-A few achievements contains actual real ranking (based on [GitHub search](https://github.com/search) results)!
-
-**About achievements ranks**
-
-Moving forward between ranks is voluntarily difficult, making it almost impossible to reach the latest rank except by hard work.
-
-With this design, when a user reach upper ranks you can be sure that they really deserve it!
-It also lets you quickly see at a glance what this user primarly use GitHub for, just look for crimson and gold badges!
-
-![Ranks](/.github/readme/imgs/plugin_achievements_ranks.png)
-
-#### ➡️ Available options
 
 <!--options-->
 <table>
@@ -36,7 +32,7 @@ It also lets you quickly see at a glance what this user primarly use GitHub for,
   </tr>
   <tr>
     <td nowrap="nowrap"><code>plugin_achievements</code></td>
-    <td rowspan="2"><p>Display achievements</p>
+    <td rowspan="2"><p>Enable achievements plugin</p>
 <img width="900" height="1" alt=""></td>
   </tr>
   <tr>
@@ -46,7 +42,8 @@ It also lets you quickly see at a glance what this user primarly use GitHub for,
   </tr>
   <tr>
     <td nowrap="nowrap"><code>plugin_achievements_threshold</code></td>
-    <td rowspan="2"><p>Display rank minimal threshold</p>
+    <td rowspan="2"><p>Display rank threshold</p>
+<p>Use <code>X</code> to display achievements not yet unlocked</p>
 <img width="900" height="1" alt=""></td>
   </tr>
   <tr>
@@ -57,7 +54,7 @@ It also lets you quickly see at a glance what this user primarly use GitHub for,
   </tr>
   <tr>
     <td nowrap="nowrap"><code>plugin_achievements_secrets</code></td>
-    <td rowspan="2"><p>Display unlocked secrets achievements</p>
+    <td rowspan="2"><p>Display secrets achievements</p>
 <img width="900" height="1" alt=""></td>
   </tr>
   <tr>
@@ -67,7 +64,11 @@ It also lets you quickly see at a glance what this user primarly use GitHub for,
   </tr>
   <tr>
     <td nowrap="nowrap"><code>plugin_achievements_display</code></td>
-    <td rowspan="2"><p>Achievements display style</p>
+    <td rowspan="2"><p>Display style</p>
+<ul>
+<li><code>detailed</code>: display icon, name, description and ranking</li>
+<li><code>compact</code>: display icon, name and value</li>
+</ul>
 <img width="900" height="1" alt=""></td>
   </tr>
   <tr>
@@ -78,7 +79,7 @@ It also lets you quickly see at a glance what this user primarly use GitHub for,
   </tr>
   <tr>
     <td nowrap="nowrap"><code>plugin_achievements_limit</code></td>
-    <td rowspan="2"><p>Maximum number of achievements to display</p>
+    <td rowspan="2"><p>Display limit</p>
 <img width="900" height="1" alt=""></td>
   </tr>
   <tr>
@@ -90,7 +91,8 @@ It also lets you quickly see at a glance what this user primarly use GitHub for,
   </tr>
   <tr>
     <td nowrap="nowrap"><code>plugin_achievements_ignored</code></td>
-    <td rowspan="2"><p>Unlocked achievements to hide</p>
+    <td rowspan="2"><p>Hide specified achievements</p>
+<p>Use names without the rank adjective (i.e. without &quot;great&quot;, &quot;super&quot; or &quot;master&quot;)</p>
 <img width="900" height="1" alt=""></td>
   </tr>
   <tr>
@@ -100,7 +102,9 @@ It also lets you quickly see at a glance what this user primarly use GitHub for,
   </tr>
   <tr>
     <td nowrap="nowrap"><code>plugin_achievements_only</code></td>
-    <td rowspan="2"><p>Unlocked achievements to display</p>
+    <td rowspan="2"><p>Restrict display to specified achievements</p>
+<p>Use names without the rank adjective (i.e. without &quot;great&quot;, &quot;super&quot; or &quot;master&quot;)</p>
+<p>This option is equivalent to <code>plugin_achievements_ignored</code> with all existing achievements but the ones listed in this option</p>
 <img width="900" height="1" alt=""></td>
   </tr>
   <tr>
@@ -111,9 +115,7 @@ It also lets you quickly see at a glance what this user primarly use GitHub for,
 </table>
 <!--/options-->
 
-*[→ Full specification](metadata.yml)*
+## ℹ️ Examples workflows
-
-#### ℹ️ Examples workflows
 
 <!--examples-->
 ```yaml

source/plugins/achievements/metadata.yml

@@ -1,5 +1,9 @@
 name: "🏆 Achievements"
 category: github
+description: This plugin displays several highlights about what you achieved on GitHub.
+examples:
+  +compact display: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.achievements.compact.svg
+  detailed display: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.achievements.svg
 index: 14
 supports:
   - user
@@ -8,15 +12,16 @@ scopes:
   - public_access
 inputs:
 
-  # Enable or disable plugin
   plugin_achievements:
-    description: Display achievements
+    description: Enable achievements plugin
     type: boolean
     default: no
 
-  # Minimal rank to display
   plugin_achievements_threshold:
-    description: Display rank minimal threshold
+    description: |
+      Display rank threshold
+
+      Use `X` to display achievements not yet unlocked
     type: string
     default: C
     values:
@@ -24,45 +29,47 @@ inputs:
       - A
       - B
       - C
-      - X   # Not unlocked
+      - X
 
-  # Display secrets achievements unlocked
   plugin_achievements_secrets:
-    description: Display unlocked secrets achievements
+    description: Display secrets achievements
     type: boolean
     default: yes
 
-  # Achievements display style
   plugin_achievements_display:
-    description: Achievements display style
+    description: |
+      Display style
+      - `detailed`: display icon, name, description and ranking
+      - `compact`: display icon, name and value
     type: string
     default: detailed
     values:
-      - detailed  # Detailed display
+      - detailed
-      - compact   # Compact display (only icon, name and value are displayed)
+      - compact
 
-  # Number of achievements events to display
-  # Set to 0 to disable limitations
   plugin_achievements_limit:
-    description: Maximum number of achievements to display
+    description: Display limit
     type: number
     default: 0
     min: 0
 
-  # List of unlocked achievements to hide
-  # Names must be given in lower case, without rank adjective
   plugin_achievements_ignored:
-    description: Unlocked achievements to hide
+    description: |
+      Hide specified achievements
+
+      Use names without the rank adjective (i.e. without "great", "super" or "master")
     type: array
     format: comma-separated
     default: ""
     example: octonaut, automator, explorer
 
-  # List of unlocked achievements to display
-  # Names must be given in lower case, without rank adjective
-  # Using this option is equivalent of using "plugin_achievements_ignored" with all existing achievements but the ones listed
   plugin_achievements_only:
-    description: Unlocked achievements to display
+    description: |
+      Restrict display to specified achievements
+
+      Use names without the rank adjective (i.e. without "great", "super" or "master")
+
+      This option is equivalent to `plugin_achievements_ignored` with all existing achievements but the ones listed in this option
     type: array
     format: comma-separated
     default: ""