added some commented documentation to final_shadow.rb for reference