STY: improve doc strings