added some TODOs
update the markdown/html