Merge pull request #12 from olekscode/main

Fixed the order of tutorials

Author: olekscode

docs/tutorials/hands-on-tutorials/custom-grid/index.md

@@ -1,5 +1,6 @@
 ---
-title: Creating a Custom Grid
+title: Custom Grid
+sidebar_position: 2
 slug: /custom-grid
 ---
 

docs/tutorials/hands-on-tutorials/publish-model-on-github/index.md

@@ -1,5 +1,6 @@
 ---
 title: Publish your model on Github
+sidebar_position: 3
 slug: /publish-model-on-github
 ---
 

docs/tutorials/hands-on-tutorials/robot-forager/index.md

@@ -1,3 +1,9 @@
+---
+title: Robot-Forager Tutorial
+sidebar_position: 1
+slug: /robot-forager-tutorial
+---
+
 # Robot-Forager Tutorial
 
 In this tutorial, you will learn how to build a very simple model in Cormas.

docs/tutorials/pharo-basics/collections.md

@@ -1,3 +1,9 @@
+---
+title: Collections
+sidebar_position: 5
+slug: /collections
+---
+
 # Collections
 
 This guide introduces you to **collections** in Pharo - groups of objects used to organize and manipulate data. You will learn how to create and use arrays, ordered collections, sets, and dictionaries, understand what makes each type special, and explore how to iterate over them with messages like `do:`, `collect:`, `select:`, and others. These operations are essential for building models and handling data effectively in Cormas. 

docs/tutorials/pharo-basics/initialize.md

@@ -1,6 +1,7 @@
 ---
-title: Initialize method
-sidebar_position: 4
+title: Initialize Method
+sidebar_position: 7
+slug: /initialize-method
 ---
 
 # Understanding the initialize method

docs/tutorials/pharo-basics/learn-pharo.md

@@ -1,3 +1,9 @@
+---
+title: Where to Learn Pharo?
+sidebar_position: 1
+slug: /where-to-learn-pharo
+---
+
 # Where to Learn Pharo?
 
 The following pages of this guide will teach you the basics of Pharo programming language and environment that are necessary to use Cormas.

docs/tutorials/pharo-basics/messages.md

@@ -1,6 +1,7 @@
 ---
-title: Understanding Messages in Pharo
-sidebar_position: 4
+title: Messages
+sidebar_position: 6
+slug: /pharo-messages
 ---
 
 In Pharo (and therefore in **Cormas**), *everything is an object* - agents, cells, plots, and even numbers and strings. Objects **interact** by *sending messages* to each other. Messages are how we tell an object what to do.
@@ -14,7 +15,7 @@ plot burn.
 Here we send the message `burn` to the object `plot`.\
 If the object knows how to respond to `burn`, it performs an action - for example, it may change its color to red and mark itself as burned.
 
-## 1. What is a Message?
+## What is a Message?
 
 A **message** in Pharo is similar to a "function call" in other languages, but it's more natural to read:
 
@@ -46,7 +47,7 @@ Here:
 - `moveTo:` is the **message** 
 - `newPlot` is an **argument** 
 
-## 2. Everything Happens by Sending Messages
+## Everything Happens by Sending Messages
 
 Objects never access another object's data directly.\
 They always **communicate by sending messages**.
@@ -62,7 +63,7 @@ This means that when you design a Cormas model, you define:
 - **the messages your agents understand** (their behavior),
 - and **the messages you send** to make them act or query information.
 
-## 3. Messages vs. Methods
+## Messages vs. Methods
 
 It's important to understand that **messages** and **methods** are not the same thing.
 
@@ -84,7 +85,7 @@ In short:
 - **Message**: what you send.
 - **Method**: what the object does when it receives that message.
 
-## 4. Messages Can Have Arguments
+## Messages Can Have Arguments
 
 Some messages require extra information, called *arguments*.
 
@@ -98,7 +99,7 @@ Here `biomass:`, `moveTo:` and `addTree:` are *keyword messages* that take argum
 
 Notice the colon (`:`) - it indicates that the message expects a value.
 
-## 5. Messages Return Values
+## Messages Return Values
 
 Each message returns a result, which can be stored or used in another message:
 
@@ -121,7 +122,7 @@ growBiomass
 Then the message `cell growBiomass` will increase the biomass by 1 and return cell. You can imagine that there is an invisible `^ self` at the end of each method.
 :::
 
-## 6. Nested Messages
+## Nested Messages
 
 You can also *nest* messages to combine multiple requests in one expression:
 
@@ -134,7 +135,7 @@ This means:
 1. Ask the forest for its largest tree.
 2. Then ask that tree for its height.
 
-## 7. Messages Can Be Chained
+## Messages Can Be Chained
 
 You can send several messages to the same object in sequence by using a semicolon (`;`):
 
@@ -146,7 +147,7 @@ This reads naturally: *"Increment, increment, then decrement the counter."*
 
 This is a key idea in Pharo - code is readable and close to natural language.
 
-## 8. Message Types
+## Message Types
 
 In Pharo, there are three kinds of messages. These are just different ways of writing instructions for objects, depending on how many arguments (extra pieces of information) they need.
 

docs/tutorials/pharo-basics/pharo-environment.md

@@ -1,3 +1,9 @@
+---
+title: Pharo Environment
+sidebar_position: 4
+slug: /pharo-environment
+---
+
 # Basics of Pharo Environment
 
 In this short guide we will teach you how to use navigate the Pharo environment and use 4 main tools: Playground, Inspector, System Browser, and Debugger. We will also teach you how to search for methods and classes with Spotter and how to browse implementors and senders of different methods and classes.
@@ -51,7 +57,8 @@ The first tool that you will learn is called _"Playground"_. It allows us to exe
 Copy the following two lines to your Playground and click on _"Do it all"_ button in the top-left corner.
 
 ```smalltalk
-StWelcomeBrowser open.Transcript open.
+StWelcomeBrowser open.
+Transcript open.
 ```
 
 ![](img/pharo-environment/playground-do-it-all.png)
@@ -67,7 +74,9 @@ You can also execute one specific line by placing your cursor on it, right click
 Let's add some more lines, evaluate (execute) them and print the result. Don't worry if the variables are highlighted in red. This happens because they are not explicitly declared. But as soon as you execute your code in the Playground, it will automatically declare all varibles for you. Select the lines that you added, right-click and select _Print it_ from the menu. You can also use the shortcut _Ctrl+P_ or _Cmd+P_ on Mac. 
 
 ```smalltalk
-a := 25.b := 75.a + b
+a := 25.
+b := 75.
+a + b
 ```
 ![](img/pharo-environment/playground-print-it.png)
 

docs/tutorials/pharo-basics/pharo-playground.md

@@ -1,3 +1,9 @@
+---
+title: Running Code in Playground
+sidebar_position: 2
+slug: /run-code-in-playground
+---
+
 # Running Code in Pharo Playground
 
 Before starting, make sure you already have Pharo installed. If not, follow the Installing Pharo section from our [How to Install Cormas](/download) tutorial.

docs/tutorials/pharo-basics/pharo-syntax.md

@@ -1,8 +1,14 @@
+---
+title: Pharo Syntax
+sidebar_position: 3
+slug: /pharo-syntax
+---
+
 # Pharo Syntax in a Nutshell
 
 Pharo is a live, object-oriented language. Everything is an object, and you send messages to objects to make them do things. This short guide covers only the essentials you need to read and write the code for Cormas models.
 
-**We encourage you to follow this tutorial hands‑on:** type each example in a Playground and try evaluating, printing, and inspecting it yourself. If you are new to Playground, check out our tutorial on [Running code in Pharo Playground](pharo-playground).
+**We encourage you to follow this tutorial hands‑on:** type each example in a Playground and try evaluating, printing, and inspecting it yourself. If you are new to Playground, check out our tutorial on [Running code in Pharo Playground](run-code-in-playground).
 
 ## Classes, Objects and Messages