Merge branch 'master' of github.com:gitlabhq/gitlabhq

doc/installation.md

@@ -4,10 +4,10 @@
 
 It may work on FreeBSD and Mac OS, but we don't test our application for these systems and can't guarantee stability and full functionality.
 
-We officially support next Linux Distributions:
+We officially support (recent versions of) these Linux distributions:
 
-- Ubuntu
-- Debian
+- Ubuntu Linux
+- Debian/GNU Linux
 
 It should work on:
 
@@ -15,26 +15,31 @@ It should work on:
 - CentOs
 - RedHat
 
-It can work on:
+You might have some luck using these, but no guarantees:
 
- - Mac Os
+ - MacOS X
  - FreeBSD
 
-It 100% **wont** work on  Windows
-
+Gitlab does **not** run on Windows and we have no plans of making Gitlab compatible.
 
 ## This installation guide created for Debian/Ubuntu and properly tested. 
 
 The installation consists of 6 steps:
 
-1. install packeges.
-2. install ruby
-3. install gitolite
-4. install gitlab and configuration. Check status configuration.
-5. server up.
-6. run resque process (for processing queue).
+1. Install packages / dependencies
+2. Install ruby
+3. Install gitolite
+4. Install and configure Gitlab.
+5. Start the web front-end
+6. Start a Resque worker (for background processing)
 
-** Before submit an installation issue - please check if you followed all steps **
+### IMPORTANT
+
+Please make sure you have followed all the steps below before posting to the mailinglist with installation and configuration questions.
+
+Only create a Github Issue if you want a specific part of this installation guide updated.
+
+Also read the [Read this before you submit an issue](https://github.com/gitlabhq/gitlabhq/wiki/Read-this-before-you-submit-an-issue) wiki page.
 
 > - - -
 > First 3 steps can be easily skipped with simply install script:
@@ -57,6 +62,9 @@ The installation consists of 6 steps:
 
     sudo apt-get install -y git-core wget curl gcc checkinstall libxml2-dev libxslt-dev sqlite3 libsqlite3-dev libcurl4-openssl-dev libreadline-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev libicu-dev redis-server openssh-server git-core python-dev python-pip sendmail
     
+    # If you want to use MySQL:
+    sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev
+
 # 2. Install ruby
 
     wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.2-p290.tar.gz
@@ -79,8 +87,6 @@ Create user for git:
       --home /home/git \
       git
 
-    
-
 Create user for gitlab:
 
     # ubuntu/debian
@@ -124,7 +130,6 @@ Permissions:
 
 **IMPORTANT! If you cant clone `gitolite-admin` repository - DONT PROCEED INSTALLATION**
 
-
 # 4. Install gitlab and configuration. Check status configuration.
 
     sudo gem install charlock_holmes