Docs: edit pull request #347 from jamesward/master

documentation/manual/deployment.textile

@@ -100,43 +100,43 @@ bc. <?xml version="1.0" ?>
   </resource-ref>
 </web-app>
 
-h2. <a name="heroku">Heroku - Cloud Application Platform</a>
+h2. <a name="heroku">Heroku</a>
 
-To run your Play application on the Cloud with Heroku, follow these steps:
+To deploy and run your Play application on the cloud with "Heroku cloud application platform":http://www.heroku.com/, follow these steps:
 
-1. Install the heroku command line client on "Linux":http://toolbelt.herokuapp.com/linux/readme, "Mac":http://toolbelt.herokuapp.com/osx/download, or "Windows":http://toolbelt.herokuapp.com/windows/download.
-2. Install "git":http://git-scm.com/ and setup your SSH key
-3. Create an account on "Heroku.com":http://heroku.com/signup
-4. Login to Heroku from the command line:
+1. Install the Heroku command line client on "Linux":http://toolbelt.herokuapp.com/linux/readme, "Mac":http://toolbelt.herokuapp.com/osx/download, or "Windows":http://toolbelt.herokuapp.com/windows/download.
+2. Install "git":http://git-scm.com/ and setup your SSH key.
+3. Create an account on "Heroku.com":http://heroku.com/signup.
+4. Log in to Heroku from the command line:
 
 bc. heroku auth:login
 
-5. Create a git repo:
+5. Create a git repository:
 
 bc. git init
 
-6. Create a @.gitignore@ file containing the following content:
+6. Create a @.gitignore@ file containing the following content, to ignore files generated by Play:
 
 bc. /tmp
 /modules
 /lib
 /test-result
 /logs
 
-7. Add the files to the git repo and commit them:
+7. Add the files to the git repository and commit them:
 
 bc. git add .
 git commit -m init
 
-8. Create a new app on Heroku:
+8. Create a new application on Heroku:
 
 bc. heroku create -s cedar
 
-9. Push the app to Heroku:
+9. Push the application to Heroku:
 
 bc. git push heroku master
 
-10. Open the app in your browser:
+10. Open the application in your browser:
 
 bc. heroku open
 
@@ -145,11 +145,10 @@ To view the logs run:
 
 bc. heroku logs
 
-To scale the application to multiple dynos run:
+To scale the application to multiple ‘dynos’ run:
 
 bc. heroku scale web=2
 
-
 Learn more in the "Heroku Dev Center":http://devcenter.heroku.com.
 
 
@@ -165,7 +164,7 @@ bc. play gae:deploy myapp
 
 Refer to the "module documentation":http://playframework.org/modules/gae-1.0.2/home for more information.
 
-h2. <a name="stax">Stax cloud hosting platform</a>
+h2. <a name="stax">Stax</a>
 
 Easy deployment to the "Stax cloud hosting platform":http://www.stax.net: again nothing could be easier. Install the Stax module and deploy within seconds.