doc formatting

doc/MacInstallation.md

@@ -7,11 +7,8 @@ Some of these steps are pulled from http://www.moncefbelyamani.com/how-to-instal
 Install homebrew
 
     \curl -sSL https://get.rvm.io | bash -s stable --rails
-
     rvm install 2.1.3 --with-gcc=clang
-
     rvm use 2.1.3
-
     gem install lunchy 
 
 Now install homebrew. 

doc/UbuntuInstallation.md

@@ -1,115 +1,97 @@
 Firstly this walkthrough is done with a 14.04 32bit install of Ubuntu.
-
+Let's check if all updates for the system are installed first. In a
-All commands that I could are terminal based.
+terminal type:
-
-Lets check if all updates for the system are installed first
-
-in terminal type
 
     sudo apt-get update
 
-now we need to install git
+Now we need to install git:
 
     sudo apt-get install git
 
-lets get our RVM installed (Ruby Version Manager) now this is fun because the package you will get from apt-get is outdated.
+Now let's get our RVM installed (Ruby Version Manager). Now this is fun
-
+because the package you will get from apt-get is outdated. So we are going
-so we are going to use CURL to get RVM
+to use CURL to get RVM
 
     sudo apt-get install curl
 
-then lets install RVM with curl like this
+Then lets install RVM with curl like this
-
-    curl -L get.rvm.io | bash -s stable
 
+    gpg --keyserver hkp://keys.gnupg.net \
+      --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
+    \curl -sSL https://get.rvm.io | bash -s stable
     PATH=$PATH:$HOME/.rvm/bin
-
     [[ -s "$HOME/.profile" ]] && source "$HOME/.profile"
-
     [[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"
-
     source ~/.rvm/scripts/rvm
 
-now we can actually install RVM
+Now we can actually install RVM
 
     rvm requirements
 
-running this will check your system for requirements as well so you will need to put your system password in.
+Running this will check your system for requirements as well so you will need to put your system password in.
 
-alright now we can download metamaps from the master using git
+All right now we can download metamaps from the master using git
 
     git clone https://github.com/metamaps/metamaps_gen002.git
 
-now there is a couple other things we are going to need which is nodejs, postgresql, libpq-dev and redis-server
+Now there is a couple other things we are going to need which is nodejs, postgresql, libpq-dev and redis-server
-
-    sudo apt-get install nodejs
 
+    sudo apt-get install nodejs npm
+    sudo ln -s /usr/bin/nodejs /usr/bin/node
     sudo apt-get install postgresql
-
     sudo apt-get install libpq-dev
-
     sudo apt-get install redis-server
 
-Furthermore, if you want to be able to work on profile picture uploading, or use it
+Furthermore, if you want to be able to work on profile picture uploading,
-you'll need ImageMagick. On Ubuntu, you can just go find ImageMagick in the Ubuntu Software Centre
+or use it you'll need ImageMagick. On Ubuntu, you can just go find
+ImageMagick in the Ubuntu Software Centre
 
 Install the specific version of ruby needed this will take some time
 
-    rvm install ruby-2.1.3
+    rvm install $(cat metamaps_gen002/.ruby-version)
 
-Now we also need to copy .example-env to a new file named .env. Review the configuration in here to see if you need any changes.
+Now we also need to copy .example-env to a new file named .env. Review the
+configuration in here to see if you need any changes.
 
     cp .example-env .env
 
-Now run inside your metamaps_gen002 folder
+Now run inside your metamaps_gen002 folder:
 
+    gem install bundle
     bundle install
 
-in your top level directory for metamaps this is a lengthy process so you might want to go and make a coffee or something :)
+in your top level directory for metamaps. This is a lengthy process so you might want to go and make a coffee or something :)
 
-alright now we need to make sure your postgres password is the same as it is listed in the DB file so we are going to set it by
+All right now we need to make sure your postgres password is the same as
+it is listed in the .env file so we are going to set it by
 
     sudo -u postgres psql
 
-Select postgres like this
+Use these commands to set the password to 3112 and then quit:
 
     \password postgres
-
-set the password to 3112
-
-Then to quit
-
     \q
 
-now we can run the rake install and db creation
+now we can use rake to create, load the schema into, and load db/seeds.rb
+into the postgres database:
 
-    rake db:create
+    rake db:setup
 
-    rake db:schema:load
+Open a new terminal, navigate to the metamaps directory, and execute the
- 
+server: 
-    rake db:fixtures:load
-
-Execute the server: 
     
     rails s
 
 and dont forget to run the other server for realtime...
-open a new terminal
-navigate to ./realtime and run 
 
-    sudo apt-get install npm
+    cd realtime
     npm install
-    nodejs realtime-server.js
+    node realtime-server.js
 
-Now you're all set enjoy your personal server of metamaps :)
+Now you're all set enjoy your personal server of metamaps :) Navigate your browser to localhost:3000 once you have the server running. Sign in with the default account
 
-Navigate your browser to localhost:3000 once you have the server running
+    email: user@user.com
-
+    password: toolsplusconsciousness
-Sign in with the default account
-
-email: user@user.com
-
-password: toolsplusconsciousness
 
 OR create a new account at /join, and use access code 'qwertyui'
 

doc/WindowsInstallation.md

@@ -4,9 +4,12 @@ Ruby, Git, and Rails: http://railsinstaller.org/en
 PostgreSQL 9.2:       http://www.enterprisedb.com/products-services-training/pgdownload
 nodejs:               http://nodejs.org/download
 
-During the installation of the PostgreSQL database, you'll need to choose a database password. Anything is fine, just note down what you choose.
+During the installation of the PostgreSQL database, you'll need to choose a
+database password. Anything is fine, just note down what you choose.
 
-Once you are ready, create a new folder to hold this and any other git repositories. As an example, let's pretend you've chose C:\git, and made that folder writable by your user account.
+Once you are ready, create a new folder to hold this and any other git
+repositories. As an example, let's pretend you've chose C:\git, and made that
+folder writable by your user account.
 
 Now you are ready to clone the Metamaps git repository:
 
@@ -14,19 +17,28 @@ Now you are ready to clone the Metamaps git repository:
     cd metamaps_gen002
     bundle install
 
-The third `bundle install` command downloads and installs the rubygem dependencies of Metamaps.
+The third `bundle install` command downloads and installs the rubygem
+dependencies of Metamaps.
   
-At this point you should be in C:\git\metamaps_gen002, or whatever equivalent directory you've chosen. The next step is to set up your database configuration. From the metamaps_gen002 directory, run
+At this point you should be in C:\git\metamaps_gen002, or whatever equivalent
+directory you've chosen. The next step is to set up your database
+configuration. From the metamaps_gen002 directory, run
 
     start config
 
-This command will open a Windows Explorer window of the "config" directory of Metamaps. Copy `.example-env`, and rename the copy to `.env`. Edit the file and set the DB_PASSWORD to be whatever you set up with postgres earlier. Once you're done, then move back into the command prompt. The next few commands will fail unless `.env` is correctly configured and Postgres is running.
+This command will open a Windows Explorer window of the "config" directory of
+Metamaps. Copy `.example-env`, and rename the copy to `.env`. Edit the file and
+set the DB_PASSWORD to be whatever you set up with postgres earlier. Once
+you're done, then move back into the command prompt. The next few commands will
+fail unless `.env` is correctly configured and Postgres is running.
 
     rake db:create
     rake db:schema:load
     rake db:fixtures:load
 
-And you're set up! At this point, you should be able to run the server at any time with only one command; you don't need to repeat any of the previous steps again. The command to run the server is:
+And you're set up! At this point, you should be able to run the server at any
+time with only one command; you don't need to repeat any of the previous steps
+again. The command to run the server is:
 
     rails s