fighting bit rot in macro docs