more doc and more flexibility in ui.append type