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

source/plugins/projects/README.md

@@ -40,16 +40,37 @@ To do so, open your repository project and retrieve the last URL endpoint, in th
 
 </details>
 
+#### ➡️ Available options
+
+<!--options-->
+| Option | Type *(format)* **[default]** *{allowed values}* | Description |
+| ------ | -------------------------------- | ----------- |
+| `plugin_projects` | `boolean` **[no]** | Display active projects |
+| `plugin_projects_limit` | `number` **[4]** *{0 ≤ 𝑥 ≤ 100}* | Maximum number of projects to display |
+| `plugin_projects_repositories` | `array` *(comma-separated,/(?<user>[-a-z0-9]+)[/](?<repo>[-a-z0-9]+)[/]projects[/](?<id>[0-9]+)/)* **[]** | List of repository project identifiers to disaplay |
+| `plugin_projects_descriptions` | `boolean` **[no]** | Display projects descriptions |
+
+
+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_projects: yes
-    plugin_projects_repositories: lowlighter/metrics/projects/1 # Display #1 project of lowlighter/metrics repository
-    plugin_projects_limit: 4                                    # Limit to 4 entries
-    plugin_projects_descriptions: yes                           # Display projects descriptions
+name: Project from a repository
+uses: lowlighter/metrics@latest
+with:
+  filename: metrics.plugin.projects.svg
+  token: ${{ secrets.METRICS_BOT_TOKEN }}
+  base: ''
+  plugin_projects: 'yes'
+  plugin_projects_repositories: lowlighter/metrics/projects/1
+  plugin_projects_descriptions: 'yes'
+
 ```
+<!--/examples-->