update to better track only important parts of the user, so logging on doesn't cause a regeneration of all the output files
decorate better, and use markdown