all tests pass using `macro[...]`
examples updated, docs updated, all systems go
more docs updated