nicer comments and a saner append function