docs: improve references [skip ci]

source/plugins/base/metadata.yml

@@ -61,7 +61,7 @@ inputs:
       Skip base content
 
       > ⚠️ Any plugin that relies on base content data may break!
-      > Only use this option when using a plugin that can be configured with `token: NOT_NEEDED`
+      > Only use this option when using a plugin that can be configured with [`token: NOT_NEEDED`](/source/plugins/core/README.md#token)
     type: boolean
     default: no
 

source/plugins/community/chess/metadata.yml

@@ -32,7 +32,7 @@ inputs:
 
   plugin_chess_user:
     description: |
-      AniList login
+      Chess platform login
     type: string
     default: .user.login
     preset: no

source/plugins/contributors/metadata.yml

@@ -56,7 +56,7 @@ inputs:
       Displayed sections
 
       - `contributors`: all contributors
-      - `categories`: contributors sorted by contributions categories (must be configured with `plugin_contributors_categories`)
+      - `categories`: contributors sorted by contributions categories (must be configured with [`plugin_contributors_categories`](/source/plugins/contributors/README.md#plugin_contributors_categories))
     type: array
     format: comma-separated
     default: contributors

source/plugins/core/metadata.yml

@@ -23,7 +23,7 @@ inputs:
     description: |
       GitHub username
 
-      Defaults to `token` owner username.
+      Defaults to [`token`](/source/plugins/core/README.md#token) owner username.
     type: string
     default: ""
     preset: no
@@ -43,7 +43,7 @@ inputs:
 
       Leave this to `${{ github.token }}` or `${{ secrets.GITHUB_TOKEN }}`, which is a special auto-generated token restricted to current repository scope.
 
-      > 💡 When using `output_action: gist`, it will use `token` instead, since gists are outside of scope
+      > 💡 When using [`output_action: gist`](/source/plugins/core/README.md#output_action), it will use [`token`](/source/plugins/core/README.md#token) instead, since gists are outside of scope
     type: token
     default: ${{ github.token }}
 
@@ -67,7 +67,7 @@ inputs:
     description: |
       Gist id
 
-      Specify an existing gist id (can be retrieved from its URL) when using `output_action: gist`.
+      Specify an existing gist id (can be retrieved from its URL) when using [`output_action: gist`](/source/plugins/core/README.md#output_action).
     type: string
     default: ""
     preset: no
@@ -76,7 +76,7 @@ inputs:
     description: |
       Output path
 
-      When using an asterisk (`*`), correct extension will automatically be applied according to `config_output` value
+      When using an asterisk (`*`), correct extension will automatically be applied according to [`config_output`](/source/plugins/core/README.md#config_output) value
     type: string
     default: github-metrics.*
 
@@ -122,6 +122,8 @@ inputs:
       Output condition
       - `always`: always try to push changes
       - `data-changed`: skip changes if no data changed (e.g. like when only metadata changed)
+
+      > ℹ️ This option is only revelant when [`config_output: svg`](/source/plugins/core/README.md#config_output) is set
     type: string
     default: always
     values:
@@ -133,9 +135,9 @@ inputs:
       Optimization features
       - `css`: purge and minify CSS styles
       - `xml`: pretty-print XML (useful to reduce diff)
-      - `svg`: optimization with SVGO (experimental, require `--optimize-svg` experimental flag)
+      - `svg`: optimization with SVGO (experimental, requires [`experimental_features: --optimize-svg`](/source/plugins/core/README.md#experimental_features))
 
-      Some templates may not support all options
+      Templates may not always honour all provided options
     type: array
     default: css, xml
     format: comma-separated
@@ -181,6 +183,8 @@ inputs:
 
       Custom CSS that will be injected in used template.
       Useful to avoid creating a new template just to tweak some styling
+
+      > 💡 *metrics* tends to avoid using `!important` rules, which means that most styling can be overriden by this option when using `!important`
     type: string
     default: ""
     extras:
@@ -193,8 +197,9 @@ inputs:
       Custom JavaScript that will be executed during puppeteer rendering.
       Useful to avoid creating a new template just to tweak some content.
 
-      Note that is it executed within puppeteer context and **not** *metrics* context.
+      > ⚠️ Note that is it executed within puppeteer context and **not** within *metrics* context.
-      It is run after transformations and optimizations, but just before resizing.
+      > No access to fetched data or configuration will be offered through this context.
+      > It is run after transformations and optimizations, but just before resizing.
     type: string
     default: ""
     extras:
@@ -264,7 +269,7 @@ inputs:
       GitHub supports additional emojis which are not registered in Unicode standard (:octocat:, :shipit:, :trollface:, ...)
       See full list at https://api.github.com/emojis.
 
-      This option has no effect when `token: NOT_NEEDED` is set.
+      This option has no effect when [`token: NOT_NEEDED``](/source/plugins/core/README.md#token) is set.
 
       May increase filesize
     type: boolean
@@ -331,9 +336,9 @@ inputs:
       - 2 values for width fist and height second, separated by a comma (`,`)
 
       Each value need to respect the following format:
-      - {number}
+      - `{number}`
-      - {number} + {number}%
+      - `{number} + {number}%`
-      - {number}%
+      - `{number}%`
 
       Percentage are relative to computed dimensions
     type: string
@@ -445,7 +450,7 @@ inputs:
 
       Action will cancel itself without any errors if requirements are not met
 
-      This option has no effect when `token` is set to `NOT_NEEDED`
+      This option has no effect when [`token: NOT_NEEDED`](/source/plugins/core/README.md#token) is set
     type: number
     default: 200
     min: 0
@@ -457,7 +462,7 @@ inputs:
 
       Action will cancel itself without any errors if requirements are not met
 
-      This option has no effect when `token` is set to `NOT_NEEDED`
+      This option has no effect when [`token: NOT_NEEDED`](/source/plugins/core/README.md#token) is set
     type: number
     default: 200
     min: 0
@@ -469,7 +474,7 @@ inputs:
 
       Action will cancel itself without any errors if requirements are not met
 
-      This option has no effect when `token` is set to `NOT_NEEDED`
+      This option has no effect when [`token: NOT_NEEDED`](/source/plugins/core/README.md#token) is set
     type: number
     default: 0
     min: 0
@@ -509,7 +514,7 @@ inputs:
     description: |
       Debug mode
 
-      This setting is automatically enable if a job fail (useful with `plugins_errors_fatal: yes`)
+      This setting is automatically enable if a job fail (useful with [`plugins_errors_fatal: yes`](/source/plugins/core/README.md#plugins_errors_fatal))
     type: boolean
     default: no
     testing: yes
@@ -553,7 +558,7 @@ inputs:
     description: |
       Dry-run
 
-      Contrary to `output_action: none`, output file won't be available in `/metrics_renders` directory
+      > ⚠️ Unlike [`output_action: none`](/source/plugins/core/README.md#output_action), output file won't be available in `/metrics_renders` directory
     type: boolean
     default: no
     testing: yes
@@ -563,7 +568,7 @@ inputs:
     description: |
       Experimental features
 
-      No backward compatibility is guaranteed for these features
+      > ⚠️ No backward compatibility is guaranteed for these features
     type: array
     format: space-separated
     default: ""

source/plugins/lines/metadata.yml

@@ -38,6 +38,8 @@ inputs:
       - `base` will display the total lines added and removed in `base.repositories` section
       - `repositories` will display repositories with the most lines added and removed
       - `history` will display a graph displaying lines added and removed over time
+
+      > ℹ️ `base` requires at least [`base: repositories`](/source/plugins/base/README.md#base) to be set
     type: array
     format: comma-separated
     default: base