second pass documenting