close #12 use decorators to measure parsing durations

* removed old comments and TODOs
* added a few docs