refactored head docs