update_doc.rb

#!/usr/bin/env ruby

root = File.expand_path '..', File.dirname(__FILE__)

unless (ARGV & %w[-h --help]).empty?
  print <<-USAGE
Usage: update_doc.rb [push]

       add 'push' if you want to push changes to github Katello/katello gh-pages
  USAGE
  exit 0
end

push_to_github = (ARGV == %w(push))

def cmd(cmd)
  puts ">> #{cmd}"
  fail "#{cmd} failed" unless system(cmd)
end

unless File.exist? "#{root}/yardoc/.git"
  Dir.chdir "#{root}/yardoc" do
    cmd 'git clone --single-branch --branch gh-pages git@github.com:Katello/katello.git .'
  end
end

Dir.chdir "#{root}/yardoc" do
  cmd 'git checkout gh-pages'
  cmd 'git fetch origin'
  cmd 'git reset --hard origin/gh-pages'
end

message = nil
Dir.chdir(root) do
  puts "commit message: #{message = `git log -n 1 --oneline`.strip}"
  cmd 'yard doc --no-cache'
end

Dir.chdir "#{root}/yardoc" do
  cmd 'git add --all'
  cmd "git commit -m '#{message}'"
  if push_to_github
    cmd 'git push origin gh-pages'
  end
end