Fix unclear macros documentation.
auto merge of #17867 : jbcrail/rust/unclear-macros-doc, r=alexcrichton

I rearranged one sentence in the macros guide to make it less awkward.