Update README for technical documentation

Updated information on how to use macros to document promise types, attributes, functions etc.