toc

Author: tib

README.md

@@ -1,3 +1,11 @@
 # Learn Swift By Examples
 
+[Swift](https://swift.org) is an open-source programming language designed for modern software development. It scales seamlessly from embedded devices and operating system kernels to mobile apps and cloud infrastructure, making it one of the most versatile languages available today.
+
+Swift is simple and expressive, with incredible performance, memory safety, and speed. It offers best-in-class interoperability with C and C++, giving developers access to decades of proven libraries and tooling.
+
+This website is a hands-on introduction to Swift with clear, practical examples. All code snippets run with the latest major Swift release, ensuring compatibility and relevance for real projects.
+
+Start learning Swift today by exploring the examples below and discover why Swift is the language of choice for everything from iOS development to server-side programming.
+
 [Learn Swift By Examples](https://learn-swift.com/)

contents/[01]hello-world/index.md renamed to contents/[01]the-print-function/index.md

@@ -1,13 +1,22 @@
 ---
-title: "Hello, World!"
+title: "The print function"
 description: ""
 order: 1
 ---
 
 The print function displays text or values on the screen. In the simplest form it means we can display messages on the command line. Create a new file named `main.swift` and place the following Swift code inside the file:
 
 ```swift
-print("Hello, world!")
+// FILE: main.swift
+
+print("Hello, World!")
+
+/**
+Run Swift files using the command line:
+
+$ swift main.swift
+> Hello, World!
+*/
 ```
 
 Run the program via the `swift main.swift` command, it will display the `Hello, World!` message. 

contents/[02]constants-and-variables/index.md

@@ -0,0 +1,30 @@
+---
+title: "Constants and variables"
+description: ""
+order: 2
+---
+
+foo
+
+```swift
+// a constant
+let name: String = "John"
+print(name) // => John
+
+name = "Bob" // => ERROR
+// Cannot assign to value:
+//     'name' is a 'let' constant
+
+// a variable
+var age: Int = 42
+age = 69
+print(age) // => 69
+```
+
+bar
+
+```sh
+swift main.swift
+```
+
+baz

contents/[02]standard-types/index.md

@@ -0,0 +1,28 @@
+---
+title: "Standard types"
+description: ""
+order: 3
+---
+
+
+foo
+
+```swift
+let b: Bool = false
+
+let i: Int = 6
+
+let f: Float = 4.20
+
+let d: Double = 6.9
+
+let s: String = "Lorem ipsum"
+```
+
+bar
+
+```sh
+swift main.swift
+```
+
+baz

contents/[03]standard-types/index.md

@@ -0,0 +1,26 @@
+---
+title: "String operations"
+description: ""
+order: 4
+---
+
+
+foo
+
+```swift
+let name = "John"
+let age = 42
+let end = "years old."
+
+// String interpolation
+print("\(name) is \(age) \(end).")
+// => John is 42 years old.
+```
+
+bar
+
+```sh
+swift main.swift
+```
+
+baz

contents/[03]values/index.md

@@ -0,0 +1,49 @@
+---
+title: "Operators"
+description: ""
+order: 5
+---
+
+
+foo
+
+```swift
+let x = 5
+let y = 5
+var z = 0
+
+z = x + y // addition
+print(z) // => 10
+
+z = x - y // subtraction
+print(z) // => 0
+
+z = x * y // multiplication
+print(z) // => 25
+
+z = x / y // division
+print(z) // => 1
+
+
+var x = 10
+
+x += 2 // addition
+print(x) // => 12
+
+x -= 2 // subtraction
+print(x) // => 10
+
+x *= 2 // multiplication
+print(x) // => 20
+
+x /= 2 // division
+print(x) // => 10
+```
+
+bar
+
+```sh
+swift main.swift
+```
+
+baz

contents/[04]string-operations/index.md

@@ -0,0 +1,49 @@
+---
+title: "Optionals"
+description: ""
+order: 6
+---
+
+
+foo
+
+```swift
+let x = 5
+let y = 5
+var z = 0
+
+z = x + y // addition
+print(z) // => 10
+
+z = x - y // subtraction
+print(z) // => 0
+
+z = x * y // multiplication
+print(z) // => 25
+
+z = x / y // division
+print(z) // => 1
+
+
+var x = 10
+
+x += 2 // addition
+print(x) // => 12
+
+x -= 2 // subtraction
+print(x) // => 10
+
+x *= 2 // multiplication
+print(x) // => 20
+
+x /= 2 // division
+print(x) // => 10
+```
+
+bar
+
+```sh
+swift main.swift
+```
+
+baz

contents/[05]operators/index.md

@@ -0,0 +1,49 @@
+---
+title: "The readline function"
+description: ""
+order: 7
+---
+
+
+foo
+
+```swift
+let x = 5
+let y = 5
+var z = 0
+
+z = x + y // addition
+print(z) // => 10
+
+z = x - y // subtraction
+print(z) // => 0
+
+z = x * y // multiplication
+print(z) // => 25
+
+z = x / y // division
+print(z) // => 1
+
+
+var x = 10
+
+x += 2 // addition
+print(x) // => 12
+
+x -= 2 // subtraction
+print(x) // => 10
+
+x *= 2 // multiplication
+print(x) // => 20
+
+x /= 2 // division
+print(x) // => 10
+```
+
+bar
+
+```sh
+swift main.swift
+```
+
+baz