Macro Object help

Is there any macro object documentation to help someone new to data architect to code macros?

I see the sample macros. But without understanding how the display, model, entity, objects all play together and what the various methods and properties do and return it is rather a feeling around in the dark experience.

I have coded against various api before, but almost always have at least a basic documentation to help understand the api model.