Add deployment automation

Author: dshevtsov

.gitignore

@@ -2,6 +2,7 @@
 ######################
 /*.db
 .DS_Store
+.vscode
 
 # Config and output files #
 ###########################

README.md

@@ -30,3 +30,20 @@ To build locally, you need Ruby 2, Bundler 1, and the following commands:
   ```
   rake preview:all
   ```
+
+## Deployment
+
+This branch is built and pushed to the gh-pages branch manually.
+
+To build and deploy the branch, run:
+
+```
+rake build_and_deploy
+```
+
+This command runs the build, moves the generated content to the gh-pages branch, and pushes it to GitHub.
+Note, that you need to set up a remote named `public` that points to https://github.com/magento/devdocs.
+
+The task creates a commit like `Deploy 7gjj0dkh`, where `7gjj0dkh` is an SHA of the source commit from the `archived-docs` branch. This will help in future debugging in case of any issues.
+After you push the updated gh-pages branch, it is deployed automatically through the GitHub pages environment to <http://magento.github.io/devdocs/>.
+You can track progress and status of deployment in [deployment history](https://github.com/magento/devdocs/deployments/activity_log?environment=github-pages) of the github-pages environment.

Rakefile

@@ -39,25 +39,30 @@ end
 desc 'Build the entire website'
 task build_and_deploy: %w[clean] do
   print 'Building the site with Jekyll: $ '.magenta
+
   # Check for uncommitted messages
   abort "\nCannot checkout. The branch contains uncommitted messages.".red unless `git status --short`.empty?
 
   # Back up an environmental variable
   jekyll_env = ENV['JEKYLL_ENV']
   ENV['JEKYLL_ENV'] = 'production'
+  # Build the site
   jekyll('build --verbose --baseurl=/devdocs')
   # Restore the environmental variable
   ENV['JEKYLL_ENV'] = jekyll_env
 
   # Remember the SHA of the built commit
   commit = `git log --pretty=format:"%h" -1`
+
+  # Deploy the site
   `git checkout gh-pages`
   `cp -R _site/ ./`
   `git add --all`
   `git commit --message "Deploy #{commit}"`
-  # `git push public`
+  `git push public`
+  `git checkout -`
 
-  puts 'Built!'.green
+  puts 'Done!'.green
 end
 
 desc 'Checkout to the master branch'