Overwork documentation (#3444)

* :memo: overwork macro documentation

* :memo: address review comments

* :wrench: add style check to Makefile

* :see_no_evil: overwork .gitignore

* :pushpin: Pygments 2.12.0 is broken

* :pencil2: fix links

* :children_crossing: adjust output to cppcheck

* :memo: add titles to more admonitions

* :pencil2: fix typos

* :memo: document future behavior change