docs: updated workflows examples and options descriptions (#772) [skip ci]

source/plugins/skyline/README.md

@@ -13,17 +13,38 @@ The *skyline* plugin lets you display your 3D commits calendar from [skyline.git
 
 This uses puppeteer to generate collect image frames, and use CSS animations to create an animated rendering (GIF images are not animated in GitHub flavored markdown rendering which is why this design choice was made).
 
+#### ➡️ Available options
+
+<!--options-->
+| Option | Type *(format)* **[default]** *{allowed values}* | Description |
+| ------ | -------------------------------- | ----------- |
+| `plugin_skyline` | `boolean` **[no]** | Display GitHub Skyline 3D calendar |
+| `plugin_skyline_year` | `number` **[current-year]** *{2008 ≤ 𝑥}* | Displayed year |
+| `plugin_skyline_frames` | `number` **[60]** *{1 ≤ 𝑥 ≤ 120}* | Number of frames |
+| `plugin_skyline_quality` | `number` **[0.5]** *{0.1 ≤ 𝑥 ≤ 1}* | Image quality |
+| `plugin_skyline_compatibility` | `boolean` **[no]** | Compatibility mode |
+
+
+Legend for option icons:
+* 🔐 Value should be stored in repository secrets
+* ✨ New feature currently in testing on `master`/`main`
+<!--/options-->
+
+*[→ Full specification](metadata.yml)*
+
 #### ℹ️ Examples workflows
 
-[➡️ Available options for this plugin](metadata.yml)
-
+<!--examples-->
 ```yaml
-- uses: lowlighter/metrics@latest
-  with:
-    # ... other options
-    plugin_skyline: yes
-    plugin_skyline_year: 0            # Set to 0 to display current year
-    plugin_skyline_frames: 60         # Use 60 frames (half-loop)
-    plugin_skyline_quality: 0.5       # Set image quality
-    plugin_skyline_compatibility: yes # Support additional browsers (⚠️ increases file size and reduce optimization)
-```
+name: GitHub Skyline
+uses: lowlighter/metrics@latest
+with:
+  filename: metrics.plugin.skyline.svg
+  token: NOT_NEEDED
+  plugin_skyline: 'yes'
+  plugin_skyline_year: 2020
+  plugin_skyline_frames: 6
+  plugin_skyline_quality: 1
+
+```
+<!--/examples-->

source/plugins/skyline/examples.yml

@@ -0,0 +1,9 @@
+- name: GitHub Skyline
+  uses: lowlighter/metrics@latest
+  with:
+    filename: metrics.plugin.skyline.svg
+    token: NOT_NEEDED
+    plugin_skyline: yes
+    plugin_skyline_year: 2020
+    plugin_skyline_frames: 6
+    plugin_skyline_quality: 1