Mirrors/rust-analyzer
2
0
Fork 0
mirror of https://github.com/rust-lang/rust-analyzer synced 2025-01-27 20:35:09 +00:00
Code Issues Projects Releases Packages Wiki Activity

minor: reword a bit

Browse source
This commit is contained in:
Aleksey Kladov 2021-08-10 14:56:55 +03:00
parent 967c088e01
commit fc48def916
1 changed files with 2 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
docs/dev/style.md
View file

@ -927,7 +927,7 @@ Between `ref` and mach ergonomics, the latter is more ergonomic in most cases, a
## Functional Combinators ## Functional Combinators
Use high order monadic combinators like `map`, `then`, only when they are a natural choice, don't bend the code to fit into some combinator. Use high order monadic combinators like `map`, `then` when they are a natural choice; don't bend the code to fit into some combinator.
If writing a chain of combinators creates friction, replace them with control flow constructs: `for`, `if`, `match`. If writing a chain of combinators creates friction, replace them with control flow constructs: `for`, `if`, `match`.
Mostly avoid `bool::then` and `Option::filter`. Mostly avoid `bool::then` and `Option::filter`.
@ -944,7 +944,7 @@ Some(x).filter(|it| it.cond())
This rule is more "soft" then others, and boils down mostly to taste. This rule is more "soft" then others, and boils down mostly to taste.
The guiding principle behind this rule is that code should be dense in computation, and sparse in the number of expressions per line. The guiding principle behind this rule is that code should be dense in computation, and sparse in the number of expressions per line.
The second example contains *less* computation -- `filter` function is an indirection for `if`, it doesn't do any useful work by itself. The second example contains *less* computation -- the `filter` function is an indirection for `if`, it doesn't do any useful work by itself.
At the same time, it is more crowded -- it takes more time to visually scan it. At the same time, it is more crowded -- it takes more time to visually scan it.
**Rationale:** consistency, playing to language's strengths. **Rationale:** consistency, playing to language's strengths.