From b440ed2dba98529e75272f6e0372151e0a542e80 Mon Sep 17 00:00:00 2001
From: Marco Ieni <11428655+MarcoIeni@users.noreply.github.com>
Date: Thu, 17 Mar 2022 13:54:57 +0100
Subject: [PATCH] idioms: intro improvements (#304)

---
 idioms/index.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/idioms/index.md b/idioms/index.md
index e03fcfa..22ebed6 100644
--- a/idioms/index.md
+++ b/idioms/index.md
@@ -1,14 +1,14 @@
 # Idioms
 
 [Idioms](https://en.wikipedia.org/wiki/Programming_idiom) 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.
+styles, guidelines and patterns largely agreed upon by a community.
+Writing idiomatic code allows other developers to understand better what is
+happening.
 
-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?
+After all, the computer only cares about the machine code that is generated
+by the compiler.
+Instead, the source code is mainly beneficial to the developer.
+So, since we have this abstraction layer, why not make it more readable?
 
 Remember the [KISS principle](https://en.wikipedia.org/wiki/KISS_principle):
 "Keep It Simple, Stupid". It claims that "most systems work best if they are