add docs and use list type