Mirrors/chatmail-core
1
0
Fork 0
mirror of https://github.com/chatmail/core.git synced 2026-10-02 11:10:25 +03:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Hocuri
2026-07-10 10:52:33 +02:00
committed by GitHub
parent 6322758482
commit 823b0741df
1 changed files with 7 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
STYLE.md
+7
View File
@@ -181,3 +181,10 @@ Calling `into()`, `try_into()` or `parse()`
creates an indirection, creates an indirection,
which is hard to follow for people who are not familiar with Rust, which is hard to follow for people who are not familiar with Rust,
or who are not using rust-analyzer. 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.