updated doc (see #34)