Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion src/coding-guidelines/macros.rst
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,8 @@ Macros
:id: rat_M9bp23ctkzQ7
:status: draft

Macros are powerful but they come at the cost of readability, complexity, and maintainability. They obfuscate control flow and type signatures.
Although the compiler reports both the macro expansion and its invocation site, diagnostics originating within macros can be more difficult to interpret than those from ordinary function or type definitions. Complex or deeply nested macros may obscure intent and hinder static analysis, increasing the risk of misinterpretation or overlooked errors during code review.


**Debugging Complexity**

Expand Down