(core): update logging macros documentation

Description

The logging macros behavior has changed since sight!501 (merged).

Proposal

• All relative documentation should be updated accordingly.
• Possibly add a new dedicated section

Outcomes

• Better documentation