Add note about sphinx-specific macros which should appear when github processes the rst