updated doc to merge of decor branch