adds a big more documentation and schema
relabeled comments and adds timers back and sets