wip

topics/Platform__Icons.md

@@ -4,9 +4,24 @@ Icons make it easy to find and explore features in ReSharper and Rider. They can
 
 Typically, icons come in different colors and tones to match the user-selected theme (light, dark). You can change the theme:
 
-- In ReSharper under `Options | Environment | General | User Interface | Application icons theme`
-- In Rider under `Preferences | Appearance & Behavior | Appearance | Theme`
-- In Visual Studio under `Options | Environment | General | Color Theme`
+- In ReSharper under <menupath>Options | Environment | General | User Interface | Application icons theme</menupath>
+- In Rider under <menupath>Preferences | Appearance &amp; Behavior | Appearance | Theme</menupath>
+- In Visual Studio under <menupath>Options | Environment | General | Color Theme</menupath>
+
+<table>
+    <tr>
+        <td>ReSharper</td>
+        <td><menupath>Options | Environment | General | User Interface | Application icons theme</menupath></td>
+    </tr>
+    <tr>
+        <td>Rider</td>
+        <td><menupath>Preferences | Appearance &amp; Behavior | Appearance | Theme</menupath></td>
+    </tr>
+    <tr>
+        <td>Visual Studio</td>
+        <td><menupath>Options | Environment | General | Color Theme</menupath></td>
+    </tr>
+</table>
 
 [//]: # (## Plugin Icon)
 [//]: # ()
@@ -16,7 +31,7 @@ Typically, icons come in different colors and tones to match the user-selected t
 
 The SDK comes with an extensive set of icons that are probably already familiar to you.
 
-You can browse the library in ReSharper's internal mode (`devenv.exe /ReSharper.Internal`) by navigating to `ReSharper | Internal | Windows | Themed Icon Viewer`:
+You can browse the library in ReSharper's internal mode (`devenv.exe /ReSharper.Internal`) by navigating to <menupath>ReSharper | Internal | Windows | Themed Icon Viewer</menupath>:
 
 ![Themed Icon Viewer](Platform__Icons__Themed_Icon_Viewer.png)
 
@@ -37,7 +52,7 @@ Similar to the icons that come out-of-the-box, you can add your own icons as _co
 
 SVG is a very rich format, but ReSharper can only create compiled icons from so-called _optimized SVGs_. Once you have your SVG, you can optimize it using the [latest version of Inkscape](https://inkscape.org/release/).
 
-Open the SVG, select `File | Save As...`, choose _Optimized SVG_, and enable the following options after hitting _Save_:
+Open the SVG, select <menupath>File | Save As...</menupath>, choose <control>Optimized SVG</control>, and enable the following options after hitting <control>Save</control>:
 
 - Options
   - Shorten color values
@@ -69,9 +84,9 @@ If your icons should adapt to different themes, you must provide multiple files
 Once your SVG icons are prepared and located in a common directory:
 
 1. Open the _Themed Icon Viewer_
-2. Choose `Add Pane | Directory with Icon Files`
+2. Choose <control>Add Pane | Directory with Icon Files</control>
 3. Select all icons you want to export
-4. Choose `Export | Export C# Code – SVG Body`
+4. Choose <control>Export | Export C# Code – SVG Body</control>
 
 A file with the compiled icons should open. Feel free to rename any of the icon, the icon pack, or move them to another namespace.