Fixing docs

Makefile

@@ -1,4 +1,4 @@
-.PHONY = all clean build
+.PHONY = all init clean build
 
 all: clean build
 

README.md

@@ -34,6 +34,8 @@ Spotifious uses Packal to make sure you always have the latest version. It gives
 
 Latest version: [v0.13](https://github.com/citelao/Spotify-for-Alfred/archive/master.zip) | Latest dev build: [v0.13](https://github.com/citelao/Spotify-for-Alfred/archive/dev.zip)
 
+An in-depth [installation guide](http:https://ben.stolovitz.com/Spotify-for-Alfred/download/) is available on the Spotifious website.
+
 1. [Download](https://github.com/citelao/Spotify-for-Alfred/archive/master.zip)
 this repository.
 2. Open `Spotifious.alfredworkflow` by double-clicking it or dragging it into
@@ -43,11 +45,10 @@ Alfred.
 5. Click `Save` to store the binding.
 6. Bind the other hotkeys as you wish. Their actions are visible in the `Text` field, under `Argument`.
 7. Pop up Spotifious with the key command you set— I would have `^⌘⏎`.
-8. Follow the instructions on the settings menu.
-9. You'll be asked to type in your country.
- - Type it in, if you'd like. This option is recommmended.
- - Choose `I'd rather not give a country!`. The country is stored locally and only sent to Spotify to narrow results, with no other identifying information, but Spotifious can avoid that if you'd prefer. Choosing this option will noticeably degrade your search results. 
- - You can always change your settings by typing `s` at the main menu.
+8. Follow the instructions on the set-up menu.
+ 1. You'll be asked to choose your country (for better search results— you can opt out).
+ 2. You'll create a Spotify application (or not, you can opt out).
+ 3. You'll link the new app to Spotifious.
 10. Continue on with your merry day— but now with Spotifious.
 
 ![A visual install guide](include/screenshots/install.png)
@@ -124,4 +125,4 @@ See `CHANGELOG.md` for more detailed information.
 - v0.5: Added a menu system
 - v0.1: Inital search system
 
-This code is MIT Licensed.
+This code is licensed as written in the LICENSE.md file.

doc/spec.md

@@ -1,15 +1,18 @@
 # How Spotifious should work #
 
-There are three specific types of output:
+There are four specific types of output:
 
 1. Main Menu — first activation
+4. Generic Menu — list of options, used for settings menu.
 2. Search Menu — user typing
 3. Detail Menu — autocompleted text with Spotify URL
 
 ## Main Menu ##
 
 `^⌘⏎` should show the main menu.
 
+It should check for updates every so often and display an update bar occasionally.
+
 1. ► Crooked Teeth ⏎ `playpause`
  - ???
 2. Plans ⏎ album detail
@@ -19,9 +22,33 @@ There are three specific types of output:
 4. Search for music...
  - Begin typing to search
 
+## Generic Menu ##
+
+We use this for the settings & setup menus.
+
+### Setup menu ###
+
+These are the options required for initial operation.
+
+- Country Code
+ - should trigger a list of countries.
+- Create a Spotify application
+ - should trigger the application-creation web server.
+- Link Spotify application
+ - should open the Spotify login page for the new app.
+
+### Settings Menu ###
+
+These are all the original setup options, plus some additional ones.
+
+- Track Notifications
+ - toggle notifications of next playing tracks
+
 ## Search Menu ##
 
-After activation, any typing at all should show the search menu, unless the query requires a detail menu (see below). The results should be weighted so artists>albums>songs— but only if the query is completely contained by the result. `Lady Danv` should return Lady Danville, then Lady Danville EP, then songs. Otherwise sort by popularity; use a unique id for each query so popular searches follow Alfred's smart order.
+After activation, any typing (3+ chars should work) should show the search menu, unless the query requires a detail menu (see below). The results should be weighted so artists>albums>songs— but only if the query is completely contained by the result. `Lady Danv` should return Lady Danville, then Lady Danville EP, then songs. Otherwise sort by popularity; use a unique id for each query so popular searches follow Alfred's smart order.
+
+If the query starts with a `c`, include control items, like play, pause, shuffle, etc.
 
 1. Lady Danville ⏎ artist detail
  - ★★★★☆ Artist
@@ -32,9 +59,22 @@ After activation, any typing at all should show the search menu, unless the quer
 
 ## Detail Menu ##
 
-I want to maintain easily navigable menus, but need to provide the Spotify URL in order to perform an artist or album lookup. To that end, the detail menu uses the syntax `spotify URL ► inital search request ►`. The script should use its smartness to detect a backspace (ie if the final triangle is missing) and provide a search menu with the initial search request. That way, a user can easily back up a level.
+I want to maintain easily navigable menus & submenus, but need to provide the Spotify URL in order to perform an artist or album lookup. To that end, the detail menu uses a smart syntax, separated by some unicode glyphs (`►` & `⟩` maybe).
+
+The query should have all URLs in hierarchical order, than all the queries in hierarchical order, followed by a closing separator:
+
+`a menu url⟩a submenu url⟩another submenu url►query used in menu⟩query used in submenu⟩query used in final submenu⟩`
+
+The different separator should be a sign that the query is parsable. If it isn't present, ignore the query.
+
+This syntax will not be compatible with the old syntax.
+
+### Playlist Detail ###
 
-**Note**: Transferring from an artist detail menu to an album detail menu should add an additional spotify URL and an extra `►`; ie `artist URL ► album URL ► initial search request ►►`. 
+1. Liked from Radio ⏎ view in Spotify
+ - View playlist in Spotify
+2. Sticking it to Myself ⏎ `open location <song>`
+ - Jonathan Coulton - Artificial Heart 2:20 ★★★☆☆ 
 
 ### Artist Detail ###
 

info.plist

@@ -586,7 +586,7 @@ Thank you everyone! Y’all made Spotifious as awesome as it is.
 
 Also thank you for using Spotifious and reading the README; I hope you enjoy it.
 
-This code is MIT Licensed.</string>
+This code’s license can be found in LICENSE.md</string>
  <key>uidata</key>
  <dict>
  <key>18496AC4-EA42-444C-A906-642E38259C96</key>