more commenting for api docs