examples: improve grammar, better MD structure & fix some code

examples/arrays/functions.md

@@ -1,38 +1,46 @@
 # Array Functions
 
-## `repeat` 
+## `repeat`
 
 Syntax
 
 ```go
-Type[element].repeat(number int)
+array.repeat(number int)
 ```
 
 Makes an array with the given element number of times.
 
 ```go
-foo := int[1].repeat(7)
+foo := [1, 2].repeat(5)
 println(foo)
 ```
+
 Output
 
 ```go
-[1, 1, 1, 1, 1, 1, 1]
+[1, 2, 1, 2, 1, 2, 1, 2, 1, 2]
 ```
 
-## insert
+## `insert`
 
 Syntax
 
 ```go
 array.insert(num int, data T)
 ```
 
-Inserts the data at a given position and shifts the elements in the array
+Inserts the data at a given position and shifts the elements in the array.
+
+<!--
+    mut names := ['Samuel', 'John', 'Peter']
+    tom := 'Tom'
+    names.insert(2, &tom)
+    println(names)
+-->
 
 ```go
-names := ['Samuel', 'John', 'Peter']
-names.insert(2,'Tom')
+mut names := ['Samuel', 'John', 'Peter']
+names.insert(2, 'Tom')
 println(names)
 ```
 
@@ -50,7 +58,7 @@ Syntax
 array.delete(element T)
 ```
 
-Deletes the element present in the array
+Deletes the element present in the array.
 
 ```go
 even_numbers = [2, 4, 6, 8, 10]
@@ -72,7 +80,7 @@ Syntax
 array.reverse()
 ```
 
-Reverses the array
+Reverses the array.
 
 ```go
 float_num := [1.1, 1.3, 1.25, 1.4]
@@ -93,7 +101,7 @@ Syntax
 array.clone()
 ```
 
-Clones and returns a new array
+Clones and returns a new array.
 
 ```go
 foo := [1, 2, 4, 5, 4, 6]

examples/conditional_statements/conditional_statements.md

@@ -15,7 +15,7 @@ if john_height < maria_height {
 }
 ```
 
-In the above code, `fn println()` will only execute when the condition is true else no statement would be printed.  
+In the above code, `fn println()` will only execute when the condition is true else no statement would be printed.
 
 ## `else` statement
 
@@ -32,8 +32,7 @@ if joey_age > kevin_age {
 }
 ```
 
-In this example the block in else will execute because the condition in `if` evaluates to false.
-
+In this example, the block in else will execute because the condition in `if` evaluates to false.
 
 ## `else if` statement
 
@@ -64,7 +63,7 @@ if tom_age < ashia_age {
     } else {
       println('tom_age >= 18 and younger than Ashia.')
      }
-   } 
+   }
    else if tom_age > ashia_age {
     println('$tom_age > $ashia_age')
    } else {
@@ -90,6 +89,7 @@ print(s)
 ```
 
 Output
+
 ```bash
 Tom is the youngest
 ```

examples/functions/functions.md

@@ -1,8 +1,8 @@
 # Functions
 
-A function is a block of organized, reusable code that is used to perform a single, related action. Functions provide better modularity for your application and a high degree of code reusing. 
+A function is a block of organized, reusable code that is used to perform a single, related action. Functions provide better modularity for your application and a high degree of code reusing.
 
-Ideally you should consider using the [single responsibility principle](https://en.wikipedia.org/wiki/Single_responsibility_principle) (SOLID) which states that every module or function should have responsibility over a single part of the functionality provided by the software to keep your code maintainable.
+Ideally, you should consider using the [single responsibility principle](https://en.wikipedia.org/wiki/Single_responsibility_principle) (SOLID) which states that every module or function should have responsibility for a single part of the functionality provided by the software to keep your code maintainable.
 
 Like C and Go, functions cannot be overloaded.
 
@@ -30,11 +30,11 @@ fn full_name(first_name, last_name string) string {
 
 ## Variadic Functions
 
-Functions can also be variadic i.e. accept infinite number of arguments. They are **not** arrays and cannot be returned.
+Functions can also be variadic i.e. accept an infinite number of arguments. They are not arrays and cannot be returned.
 
 ```go
 fn main() {
-	foo("V", "is", "the", "best", "lang" , "ever")	
+	foo("V", "is", "the", "best", "lang" , "ever")
 }
 
 fn foo(test ...string) {
@@ -55,10 +55,10 @@ ever
 
 ## Multi-Return Functions
 
-Similar to Go, functions in V can also return multiple and with different type.
+Similar to Go, functions in V can also return multiple and with a different type.
 
 ```go
-fn main() {	
+fn main() {
 	name, age := student("Tom", 15)
 	println(name, age)
 
@@ -77,15 +77,15 @@ Tom , 15
 
 ## High Order Functions
 
-Functions can also take in another function which is usually needed to sort, map, fitler etc.
+Functions in V can also take in another function which is usually needed to sort, map, fitler etc.
 
 ```go
 fn square(num int) int {
 	return num * num
 }
 
 fn run(value int, op fn(int) int) int {
-        return op(value)
+	return op(value)
 }
 
 fn main() {
@@ -104,5 +104,5 @@ Output
 1. Write a V program to find the square of any number using the function.
 2. Write a V program to check a given number is even or odd using the function.
 3. Write a V program to convert decimal number to binary number using the function.
-4. Write a V program to check whether a number is a prime number or not using the function. 
+4. Write a V program to check whether a number is a prime number or not using the function.
 5. Write a V program to get the largest element of an array using the function.