diff --git a/README.md b/README.md
index 4090806..2bc0fa3 100644
--- a/README.md
+++ b/README.md
@@ -50,8 +50,6 @@ best components of vimium and adapting them to Safari.
 7. Go back to Vimari.app and press the reload button to check the status of the app. If it says "Enabled" then it is ready.
 8. You may need to relaunch Safari for the extension to work
 
-
-
 ### Safari 11 (legacy Safari Extension method)
 
 [Download the Vimari 1.13](https://github.com/guyht/vimari/releases/tag/v1.13) and double-click
@@ -100,6 +98,17 @@ for HTML elements having cursor style set to "pointer".
     x       Close current tab
     t       Open new tab
 
+## Known Limitations
+
+There are some limitations in the Safari extensions API, which in turn
+limit Vimari. 
+
+1. On an "Empty Page", a "Top Sites" page, a "Favourites" page, 
+or a page which doesn't load like localhost, Vimari is not injected, 
+and cannot provide any keyboard shortcuts. To work around this, use
+the regular Safari shortcuts for navigating away from a new window
+or new tab.
+
 ## License
 
 Copyright (C) 2011 Guy Halford-Thompson. See [LICENSE](LICENSE) for details.
diff --git a/docs/safari_12.md b/docs/safari_12.md
index 8ec41ae..d41c646 100644
--- a/docs/safari_12.md
+++ b/docs/safari_12.md
@@ -1,19 +1,18 @@
 # Installation notes for Safari version 12 and 13
 
-A new version of macOS is being released, macOS Mojave, and it's expected to
-have a stable release out September or October of 2018. With that new version
-comes Safari 12, and a [completely new way of dealing with browser
-extensions](https://developer.apple.com/documentation/safariservices/safari_app_extensions).
+In September 2018 macOS Mojave was released. This came with Safari 12, and a 
+[completely new way of dealing with browser extensions]
+(https://developer.apple.com/documentation/safariservices/safari_app_extensions).
  [We have had some issues](./crowdfunding.md) related to releasing new version
 of this extension, but they are now fixed and it's possible to install a version
-of vimari for Safari 12.
+of vimari for Safari 12+.
 
-## How to install
+## How to install for development
 **Note: We are currently working on improving this installation flow, as well
 as the extension itself. Because vimari now has to be released as a _Safari
 App Extension_ instead of a _Safari Extension_ it requires some fundamental
 changes to the code. We can't guarantee that all the features work in
-this version. It's a learning process for us so bare with us.**
+this version. It's a learning process for us so bear with us.**
 
 1. Clone this repo
     ```sh
@@ -32,5 +31,6 @@ this version. It's a learning process for us so bare with us.**
 7. You may now press stop in Xcode and close Xcode. The extension will be
    available even if you restart Safari.
 
-This was tested on High Sierra with Safari Technology Preview (version 12). Let
-us know if something is not working for you.
+This was tested on High Sierra with Safari Technology Preview (version 12) and 
+on Catalina with Safari 13.0.3 (Xcode 11.2.1). Let us know if something is not 
+working for you.