discovery macros are currently listed, but there is no description on what data exactly and in what format they return. for example, format for uptime macros is unclear.

these should be documented, including a few examples as well