Coding-Guidelines.md

@@ -66,37 +66,41 @@ Things that are being checked by the linter:
 
 The software is a really simple collection of scripts, and it can produce false-positives.
 
-**CLang**
+**CLang-format**
 
-Se avete un plugin per il vostro ide tanto meglio, altrimenti potete lanciarlo
-da command line con
-`cat source.cpp | clang-format > source_figo.cpp`
-oppure
+Clang-format is a tool that helps mantaining the code clean and consistent with the chosen codestyle.
+
+There are many plugins out there for most of the IDEs (Vim, Visual Studio, Eclipse...). 
+Otherwise you can run it from terminal: 
+`cat source.cpp | clang-format > nice_style_source.cpp`
+or 
 `clang-format -i source.cpp`
-oppure 
+or 
 `find src/ -iname "*.cpp" -exec clang-format -i "{}" \;`
-(ocio a tenere 'src/' se no reindenta tutto miosix XD)
+(Remember the `src/`, otherwise the whole Miosix codebase will be formatted).
+
 
-clang-format cerca un file chiamato '.clang-format' nella cartella attuale
-o va a guardare tutte tutte le cartelle sopra. Se non lo trova, usa una config
-di default che non mi piace (lo vedert subito perche usa 2 spazi e parentesi
-in linea).
+Clang-format  will search for a file called `.clang-format` in the working folder
+or parent folders. If it doesn't find it, a default format will be used (you can tell
+it's using the default style if you see spaces between `()` ).
 
-Ho visto che ogni tanto (non capisco il criterio) decide di indentare male
-le enum belle allineate. Potete evitare che tocchi qualche zona di codice
-mettendola fra
+Sometimes it uses a strange indentation for enums. In general, if you don't want
+a particular part of the code to be touched by clang-format, put it inside a:
 ```
 // clang-format off
 ...codice da non toccare
 // clang-format on
 ```
 
-Also, below you will find a description of how source files should be structured.
-
-## Entrypoints Structure
+Files Stucture
+-------------------
 
 *TODO FILE NAMING CONVENTIONS*
 
+Also, below you will find a description of how source files should be structured.
+
+### Entrypoints Structure
+
 *TODO COMMENT WITH \arg \returns ?*
 
 #### 1) Copyrigth
@@ -204,7 +208,7 @@ void useLongNames(int explicitArg)
 }
 ```
 
-## Header Files Structure
+### Header Files Structure
 ```cpp
 /*LICENSE*/
 #ifndef YOURHEADER_H