docs(installation guide):update installation guide

docs/installation/linux-installation.md

@@ -14,7 +14,7 @@ There are two ways to install zanata-client, via `0install` or `yum`.
 
 3. Use `zanata-cli` as alias: 
 
-        0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
+        mkdir -p ~/bin | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
 
 4. It should be done now. Run `zanata-cli --help` for the usage of the client.
 
@@ -59,7 +59,7 @@ There are two ways to install zanata-client, via `0install` or `yum`.
 
 4. Use `zanata-cli` as alias: 
 
-        0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
+        mkdir -p ~/bin | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
 
 5. It should be done now. Run `zanata-cli --help` for the usage of the client.
 
@@ -86,7 +86,7 @@ There are two ways to install zanata-client, via `0install` or `dnf`.
 
 2. Use `zanata-cli` as alias: 
 
-        0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
+        mkdir -p ~/bin | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
 
 3. It should be done now. Run `zanata-cli --help` for the usage of the client.
 
@@ -108,7 +108,7 @@ There are two ways to install zanata-client, via `0install` or `dnf`.
 
 3. Use `zanata-cli` as alias: 
 
-        0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
+        mkdir -p ~/bin | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
 
 4. It should be done now. Run `zanata-cli --help` for the usage of the client.
 
@@ -119,7 +119,7 @@ There are two ways to install zanata-client, via `0install` or `dnf`.
 2. Install Java JRE (1.8 onwards) from [OpenJDK installation](http://openjdk.java.net/install/index.html)
 3. Use `zanata-cli` as alias: 
 
-        0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
+        mkdir -p ~/bin | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
 
 4. It should be done now. Run `zanata-cli --help` for the usage of the client.
 

docs/installation/osx-installation.md

@@ -1,21 +1,12 @@
-1. Click [here](http://downloads.sourceforge.net/project/zero-install/0install/2.8/ZeroInstall.pkg) to download binary package of [0Install for OS X](http://0install.net/install-osx.html).
-2. Install 0Install: `sudo installer -pkg ZeroInstall.pkg -target`.
-3. Install homebrew: `ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
-4. Install cask: `brew install caskroom/cask/brew-cask`.
-5. Install Java runtime: `brew cask install java`.
-6. Setup alias: `0install -c add zanata-cli http://zanata.org/files/0install/zanata-cli.xml`.
-7. Now you can run `zanata-cli --help` for more options.
+## With Homebrew
 
-*Note: If you have installed `zanata-cli` previously through another method, you need to uninstall that for this to work.*
+1. Install [Homebrew](http://brew.sh/): `ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
+  - If you already have Homebrew installed, run `brew update` to pull in the latest formulae.
+2. If you **don't** have Java 1.7+, you can install it using `brew install brew-cask && brew cask install java`.
+3. Install the zanata-client: `brew install zanata-client`
+4. Now you can run `zanata-cli --help` for more options.
 
-### Useful command
+### Upgrading
 
-**Run Zanata-CLI without alias**
-```
-0launch http://zanata.org/files/0install/zanata-cli.xml {command}
-```
-
-**Update Zanata-CLI manually**
-```
-0install update http://zanata.org/files/0install/zanata-cli.xml
-```
+1. Run `brew update`
+2. Run `brew upgrade zanata-client`

docs/installation/windows-installation.md

@@ -1,5 +1,5 @@
 1. Click [here](http://0install.de/files/zero-install.exe) to download and install [0Install for Windows](http://0install.net/install-windows.html).
-2. Run `0install -c add zanata-cli http://zanata.org/files/0install/zanata-cli-jre.xml` to setup alias.
+2. Run `0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli-jre.xml` to setup alias.
 3. Now you can run `zanata-cli --help` for more options.
 
 *Note: If you have installed `zanata-cli` previously through another method, you need to uninstall that for this to work.*
@@ -10,14 +10,14 @@
 
 **Run Zanata-cli without alias**
 ```
-0launch http://zanata.org/files/0install/zanata-cli-jre.xml {command}
+0launch https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli-jre.xml {command}
 ```
 
 **Update Zanata-cli manually**
 ```
-0install update http://zanata.org/files/0install/zanata-cli-jre.xml
+0install update https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli-jre.xml
 ```
 
 **Zanata-cli feed without JRE dependency**
 
-`http://zanata.org/files/0install/zanata-cli.xml`
+`https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml`