document the expected html function