add documentation for final_status