diff --git a/src/docs/platforms.md b/src/docs/platforms.md
index 343919c..e5207a8 100644
--- a/src/docs/platforms.md
+++ b/src/docs/platforms.md
@@ -3,8 +3,8 @@ title: Platforms (icons)
 ---
 
 Find available social media / platform icons in `src/_includes/svg` (prefixed with `platform-`).
-If you add new icons they too must be prefixed with "platform-".
+If you add new icons, prefix their name with "platform-".
 
-In `personal.yaml` you can add new platforms and their URLs. The key must be the same as the prefix of the icon.
+In `personal.yaml` you can add new platforms and their URLs. The key should be the same as the name of the icon. For example: `mastodon: 'https://front-end.social/@lene'` and `platform-mastodon.svg`.
 
 https://simpleicons.org/ features a great variety of free SVG icons for popular brands.