This is covered in the porting guide, and we have complete docstrings for these macros, but having discussion here helps new users understand how to use these and why they exist. Signed-off-by: Andrew Boie <andrew.p.boie@intel.com>