first draft of macro documentation