846: improve doc