XWIKI-9176: New XWiki Syntax Guide

 * updated macro section after discussion on the issue