improve doc (ref #35)