You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
patterns/idioms
Riley Shea 4017a73d62
Fix default idiom example (#134)
Before this change, the example code doesn't run on the current rust stable release(1.49).
This is because `Path` inherently has a u8 that requires the sized trait which requires either statics or replacing Path with PathBuf.

After this change, the example code will run "as-is" without warnings or errors.
4 years ago
..
README.md Add introductions (#117) 4 years ago
concat-format.md Fix a slight typo 6 years ago
ctor.md Add doc tests to CI (#124) 4 years ago
default.md Fix default idiom example (#134) 4 years ago
deref.md Add doc tests to CI (#124) 4 years ago
dtor-finally.md Add doc tests to CI (#124) 4 years ago
mem-replace.md Added comment to explain second example 8 years ago
on-stack-dyn-dispatch.md Fix on-stack dispatch example (#137) 4 years ago
option-iter.md option-iter: Fix typo in `extend` example 7 years ago
pass-var-to-closure.md Add doc tests to CI (#124) 4 years ago
priv-extend.md Add doc tests to CI (#124) 4 years ago
rustdoc-init.md Add doc tests to CI (#124) 4 years ago
temporary-mutability.md Add doc tests to CI (#124) 4 years ago

README.md

Idioms

Idioms are commonly used styles and patterns largely agreed upon by a community. They are guidelines. Writing idiomatic code allows other developers to understand what is happening because they are familiar with the form that it has.

The computer understands the machine code that is generated by the compiler. The language is therefore mostly beneficial to the developer. So, since we have this abstraction layer, why not put it to good use and make it simple?

Remember the KISS principle: "Keep It Simple, Stupid". It claims that "most systems work best if they are kept simple rather than made complicated; therefore, simplicity should be a key goal in design, and unnecessary complexity should be avoided".

Code is there for humans, not computers, to understand.