Added a new lesson on programming languages in general.

razorblade23 · razorblade23 · commit 3079a86d0251 · 2026-03-22T22:06:42.000+01:00
diff --git a/curriculum/01-foundations/02-programming-languages.md b/curriculum/01-foundations/02-programming-languages.md
@@ -0,0 +1,60 @@
+---
+id: programming-languages
+title: What is a programming language?
+sidebar_label: 2. What is a programming language?
+sidebar_position: 2
+---
+
+# What is a programming language?
+
+Think of a **programming language** as a bridge between humans and computers. Computers don't understand English or Spanish; they only understand electricity (on or off). A programming language allows us to write instructions in a way that humans can read, which then get translated into something the computer can execute.
+
+At its heart, programming is about two things: **Data** (the information) and **Algorithms** (the instructions).
+
+## Data Structures: Organizing Information
+Before a computer can process information, it needs to organize it. This is called a **Data Structure**. 
+
+Imagine you are organizing a kitchen. You put eggs in a carton, flour in a jar, and milk in a jug. Each container is "structured" to hold that specific type of item efficiently.
+* **Simple Example:** A "Floating Point" number is just a fancy name for a decimal (like `1.45`). 
+* **Built-in Types:** Most languages, including Python, have these "containers" ready for you to use (like integers, text, or lists).
+* **Custom Structures:** As you get more advanced, you can build your own "containers" to fit the specific needs of your app.
+
+## Algorithm: The Step-by-Step Recipe
+An **algorithm** is simply a list of steps to finish a task. If you have ever followed a recipe to bake a cake, you have executed an algorithm!
+
+In programming, an algorithm must be:
+1. **Finite:** It has a clear beginning and end.
+2. **Well-defined:** Each step is precise so the computer doesn't get confused.
+
+## Language Elements
+Every language has a set of rules that determine if your code will actually run.
+
+### 1. Syntax (The Grammar)
+Just like English has rules (sentences start with a capital letter and end with a period), programming has **Syntax**. If you forget a colon or a parenthesis in Python, the computer will give you a "Syntax Error" because it doesn't recognize the "sentence" you wrote.
+
+### 2. Semantics (The Meaning)
+Syntax is about the *form*, but Semantics is about the *meaning*. 
+* **Static Semantics:** These are rules checked before the program runs (like making sure you aren't trying to "multiply" a word by a color).
+* **Dynamic Semantics:** This is what actually happens while the program is running. It’s the "behavior" of your code.
+
+### 3. Type System
+The **Type System** categorizes data so the computer knows what it can do with it. For example, you can add two numbers together ($2 + 2 = 4$), but you can't necessarily "add" a number to a list of names.
+
+* **Static vs. Dynamic:** Python uses **Dynamic Typing**. This means you don't have to tell the computer "this is a number" beforehand; it figures it out while the program is running.
+* **Strong vs. Weak:** Python is **Strongly Typed**. It won't let you do "weird" things—like adding the number `5` to the word `"Apple"`—without you explicitly converting them first.
+
+---
+
+## Programming Paradigms (Styles of Coding)
+A "paradigm" is just a style or approach to writing code. Two of the most common are:
+
+* **Imperative:** You give the computer a list of direct commands. "Go to the fridge, get the milk, pour it in a glass."
+    * **Procedural:** Organizing those commands into "blocks" or functions.
+    * **Object-Oriented (OOP):** Organizing code by grouping data and actions together (like creating a "Car" object that has data like "Color" and actions like "Drive").
+* **Declarative:** You describe *what* you want, but not exactly *how* to do it (like a GPS—you give it the address, and it figures out the turns).
+
+### Which one is Python?
+Python is a "Multi-paradigm" language. This is why it is so popular for beginners! You can write simple lists of instructions (Imperative), or you can build complex systems using Objects (OOP).
+
+## Next steps
+Now that we are familiar with *programming languages* in general, its time to move on to our target. The **Python** programming language.
diff --git a/curriculum/01-foundations/03-why-python.md b/curriculum/01-foundations/03-why-python.md
@@ -1,9 +1,19 @@
 ---
 id: why-python
 title: What is Python
-sidebar_label: 2. What is Python
-sidebar_position: 2
+sidebar_label: 3. What is Python
+sidebar_position: 3
 ---
+## What is a programming language?
+A programming language is a formal language to define **data structures** and **algorithms**. It is used to instruct a machine to perform a well-defined task. Most languages also provide means to **control the program flow**, that is the order in which the instructions of an algorithm are executed. The instructions itself are build according to grammar of the programming language, called the **syntax**.
+
+### Data Structure
+Data structures are used to organize information in a way that enables efficient access and modification of the data. A simple example is a floating point number where the respective information is an actual number, such as `1.45`. A programming language offers a way to store the number and it offers operators on it, e.g. summation and multiplication. How the number is actually stored in memory and how the operations are performed is hidden away from the programmer. A floating point number is, in most programming languages, a build-in data type which means that it is readily available to the programmer. Many programming languages also allow to create new data structures, based on existing ones. This allows the programmer to design application specific data structures.
+
+### Algorithm
+A algorithm is a finite sequence of well-defined instructions to solve a problem or to perform a computation. The concept of an algorithm is quite old and exists since the antique, e.g. in the form of arithmetic algorithms such as the [Euclidean algorithm](https://en.wikipedia.org/wiki/Euclidean_algorithm) to compute the greatest common divisor. Since the order of execution of the instructions are well-defined, algorithms can be easily implemented in a machine executable way which is one task of the programmer.
+
+
 # Why Should You Use Python?
 
 **Python** is a versatile, high-level programming language designed with a clear philosophy: code should be as easy to read as it is to write. Because its syntax closely mimics the English language, it removes the "language barrier" between your ideas and the computer, making it an ideal choice for beginners and professionals alike.
diff --git a/curriculum/01-foundations/04-print-function.md b/curriculum/01-foundations/04-print-function.md
@@ -1,8 +1,8 @@
 ---
 id: print-function
 title: The Print Function
-sidebar_label: 3. The Print Function
-sidebar_position: 3
+sidebar_label: 4. The Print Function
+sidebar_position: 4
 ---
 
 # The Print Function: Recording Your First Entry
@@ -71,7 +71,7 @@ Everything after `#` is considered a comment.
 ```
 
 <details>
-  <summary>Read more about `print()` function</summary>
+  <summary>📚 Deep Dive</summary>
 
 `print()` function has a few other arguments that you can use to further format your text on the screen.
 
diff --git a/curriculum/01-foundations/05-variables.md b/curriculum/01-foundations/05-variables.md
@@ -1,8 +1,8 @@
 ---
 id: variables
 title: Variables
-sidebar_label: 4. Variables
-sidebar_position: 4
+sidebar_label: 5. Variables
+sidebar_position: 5
 ---
 
 # Variables: Labeling the Ledger
@@ -75,17 +75,7 @@ Let's use variables to build a mini "Character Sheet" for your coding journey.
 ---
 
 <details>
-  <summary>Read more about variables</summary>
-
-`print()` function has a few other arguments that you can use to further format your text on the screen.
-
-Full function signiture is as follows:
-```python
-print(*objects, sep=' ', end='\n', file=None, flush=False)
-```
-
-To learn more about this specific function and its arguments, visit:
-* [Official python documentation](https://docs.python.org/3/library/functions.html#print)
+  <summary>📚 Deep Dive</summary>
 
 Other resources:
 * [Geomar.de: Variables and Assignment](https://2025-pherwiss-2-945e87.pages.geomar.de/content/02_python_basics/02_variables_assignments.html)
diff --git a/curriculum/01-foundations/06-data-types.md b/curriculum/01-foundations/06-data-types.md
@@ -1,8 +1,8 @@
 ---
 id: data-types
 title: Data Types
-sidebar_label: 5. Data Types
-sidebar_position: 5
+sidebar_label: 6. Data Types
+sidebar_position: 6
 ---
 
 # Data Types: Sorting the Ledger
@@ -72,9 +72,9 @@ You are auditing your supply of "Coding Fuel."
 ---
 
 <details>
-  <summary>Read more about primitive data types</summary>
+  <summary>📚 Deep Dive</summary>
 
-These represent the smallest possible unit of information that can be stored.
+Primitive data types represent the smallest possible unit of information that can be stored.
 In python, these are the ones listed above, as well as `complex` which is used for scientific calculations and wont be part of this course. 
 
 To learn more about primitive data types in python, visit:
diff --git a/curriculum/01-foundations/07-numbers-and-math.md b/curriculum/01-foundations/07-numbers-and-math.md
@@ -1,8 +1,9 @@
 ---
 id: numbers-and-math
 title: Numbers and Math
-sidebar_label: 6. Numbers and Math
-sidebar_position: 6
+sidebar_label: 7. Numbers and Math
+sidebar_position: 7
+
 ---
 
 # Numbers and Math: Balancing the Ledger
@@ -79,6 +80,17 @@ You are calculating the final balance of a ledger entry after a year of 5% inter
 
 ---
 
+<details>
+  <summary>📚 Deep Dive</summary>
+
+Other resources:
+* [Python Docs: Numeric Types](https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-complex)
+* [Programiz: Python Operators](https://www.programiz.com/python-programming/operators)
+* [Geomar.de: Primitive Data Types](https://2025-pherwiss-2-945e87.pages.geomar.de/content/02_python_basics/04_primitive_data_types.html)
+* [Pieriantraining.com: Python primitive data types - a comprehensive tutorial](https://pieriantraining.com/python-primitive-data-types-a-comprehensive-tutorial/)
+
+</details>
+
 ## 📚 Deep Dive
 * [Python Docs: Numeric Types](https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-complex)
 * [Programiz: Python Operators](https://www.programiz.com/python-programming/operators)
diff --git a/curriculum/01-foundations/08-comparisons.md b/curriculum/01-foundations/08-comparisons.md
@@ -1,8 +1,8 @@
 ---
 id: comparisons
 title: Comparison Operators
-sidebar_label: 7. Comparisons
-sidebar_position: 7
+sidebar_label: 8. Comparisons
+sidebar_position: 8
 ---
 
 # Comparisons: Auditing the Ledger
diff --git a/curriculum/01-foundations/09-if-statements.md b/curriculum/01-foundations/09-if-statements.md
@@ -1,8 +1,8 @@
 ---
 id: if-statements
 title: If Statements
-sidebar_label: 8. If Statements
-sidebar_position: 8
+sidebar_label: 9. If Statements
+sidebar_position: 9
 ---
 
 # If Statements: The Fork in the Road
diff --git a/curriculum/01-foundations/10-loops.md b/curriculum/01-foundations/10-loops.md
@@ -1,8 +1,8 @@
 ---
 id: loops
 title: Loops
-sidebar_label: 9. Loops
-sidebar_position: 10
+sidebar_label: 10. Loops
+sidebar_position: 11
 ---
 
 # 🐍 Welcome to the Loop Zone! Python `for` and `while` Loops
diff --git a/curriculum/01-foundations/project-1-text-adventure.md b/curriculum/01-foundations/project-1-text-adventure.md
@@ -2,7 +2,7 @@
 id: project-1-text-adventure
 title: "Project 1: The Ledger of Fate"
 sidebar_label: "🏆 Project 1: Text Adventure"
-sidebar_position: 9
+sidebar_position: 10
 ---
 
 # 🏆 Project 1: The Ledger of Fate
