docs: Update STYLE.md: macros should be used only when necessary (#8410)

This commit is contained in:
Hocuri
2026-07-10 10:52:33 +02:00
committed by GitHub
parent 6322758482
commit 823b0741df

View File

@@ -181,3 +181,10 @@ Calling `into()`, `try_into()` or `parse()`
creates an indirection,
which is hard to follow for people who are not familiar with Rust,
or who are not using rust-analyzer.
## Use macros only when really needed
Macros can be hard to read for people unfamiliar with Rust,
and can have surprising effects like evaluating arguments multiple times.
Therefore, macros should only be used when really needed;
using functions is usually better.