array dictionary : improve docblocks