Merge pull request #6 from DaveEveritt/patch-1

Add Homebrew to install and note on code signing

docs/Introduction.md

@@ -28,10 +28,22 @@ The latest version runs on macOS 10.10 or later. [Previous versions](https://qsa
 
 ## Installing Quicksilver
 
+From the Disc Image (.dmg) file:
+
   1. [Download Quicksilver](https://qsapp.com/download.php).
   2. Open the `.dmg` file and drag Quicksilver to your Applications folder.
   3. Unmount the Quicksilver volume and delete the `.dmg` file.
 
+Using Homebrew:
+
+[Homebrew is a package manager for OS X](https://brew.sh) for installs, updates and uninstalls of most OS X software:
+
+Open Terminal, type `brew install --cask quicksilver`. You can `uninstall` just as easily. 
+
+## First Launch
+
+Due to the way Quicksilver is built, macOS raises a [code signing warning (open issue)](https://github.com/quicksilver/Quicksilver/issues/2576))—the quickest way to get around this is to <kbd>ctrl-</kbd> or <kbd>right-click</kbd> the Quicksilver app in Applications, choose "open" from the contextual menu, *then* choose the *extra "open" button* that now appears in the warning dialog box. This only needs doing once, Quicksilver will then launch in future without further issue.
+
 On first launch, Quicksilver presents some setup options (it can be rerun later with the Run Setup button in the Application Preferences). Choose a shortcut that activates the Quicksilver command window, or just accept the default, <kbd>⌃</kbd><kbd>Space</kbd>. Quicksilver will recommend plugins based on applications you have installed and other criteria.
 
 Initially, Quicksilver shows no windows when it is running. Activate Quicksilver using the shortcut <kbd>⌃</kbd><kbd>Space</kbd> (if you accepted the default).
@@ -323,4 +335,4 @@ Details on setting up synonyms can be found in the Preferences section.
 
 A slightly different matching algorithm can be installed using the TextStart Ranker plugin and selecting it as the String Ranker handler in Preferences. In general it works better matching acronyms over continuous letters in the name of something. Specifically, it makes two changes to the algorithm. 
 
-The first is that it favors letters at the beginning of words more. E.g., if the input is <kbd>A</kbd><kbd>M</kbd> it will match “Activity Monitor” over “Amazon” since two beginning of word letters are matched instead of just one. The second difference is that it favors input that matches a higher percentage of the words. So the input <kbd>A</kbd><kbd>M</kbd> will favor “Activity Monitor” over “Audio MIDI Setup” since all the words are matched (2 out of 2) instead of two thirds of them (2 out of 3).
+The first is that it favors letters at the beginning of words more. E.g., if the input is <kbd>A</kbd><kbd>M</kbd> it will match “Activity Monitor” over “Amazon” since two beginning of word letters are matched instead of just one. The second difference is that it favors input that matches a higher percentage of the words. So the input <kbd>A</kbd><kbd>M</kbd> will favor “Activity Monitor” over “Audio MIDI Setup” since all the words are matched (2 out of 2) instead of two thirds of them (2 out of 3).