document correctly