changed docs to YARD for head_object.rb

open to any suggestions, tips, or critiques (currently learning YARD documentation)