improve append_list
update docs