diff --git a/docs/tutorial/mac-app-store-submission-guide.md b/docs/tutorial/mac-app-store-submission-guide.md
index f96808c4987f..10c59906a2b8 100644
--- a/docs/tutorial/mac-app-store-submission-guide.md
+++ b/docs/tutorial/mac-app-store-submission-guide.md
@@ -217,12 +217,14 @@ more details.
 
 ## Known issues
 
-#### `shell.openItem(filePath)` #9005
+### `shell.openItem(filePath)` 
 
 This will fail when the app is signed for distribution in the Mac App Store.
+Subscribe to [#9005](https://github.com/electron/electron/issues/9005) for updates.
 
-##### Workaround
-`shell.openExternal('file://' + filePath)` will open the file in the default application (as long as the extension is associated with an app).
+#### Workaround
+
+`shell.openExternal('file://' + filePath)` will open the file in the default application as long as the extension is associated with an installed app.
 
 ## Cryptographic Algorithms Used by Electron