I'd prefer not to tell people that partial view macros are like MacroScripts. MacroScripts are 100% legacy, new people coming to Umbraco should hopefully not know or care what these are.
We should have a more concise description of what a Partial View Macro actually is and does. Then below we can have a link to another page an how to convert a legacy macro script to a partial view macro.