[enh] improved documentation