Documentation macro overhaul and fixes

Accompanies changes in https://github.com/D-Programming-Language/d-programming-language.org/pull/271.