macros and actions documentation updates