Commit 9a9278eb0e78add9fa6dcae84d44d2d02294c5ed

Thomas de Grivel 2025-03-31T20:26:20

rename map, reword str

diff --git a/doc/1_KC3/1.03_Map.en.md b/doc/1_KC3/1.03_Map.en.md
deleted file mode 100644
index 863fdf7..0000000
--- a/doc/1_KC3/1.03_Map.en.md
+++ /dev/null
@@ -1,71 +0,0 @@
-# 1.3 Map
-
-KC3 maps are like Elixir maps, they are key-values enclosed in `%{}` :
-
-```elixir
-ikc3> a = %{id: 1, title: "My title", message: "Hello, world !"}
-%{id: 1,
-  title: "My title",
-  message: "Hello, world !"}
-```
-
-Destructuring works with maps to extract values :
-
-```elixir
-ikc3> %{id: id, title: "My title", message: message} = ^ a
-%{id: 1,
-  title: "My title",
-  message: "Hello, world !"}
-ikc3> id
-1
-ikc3> message
-"Hello, world !"
-```
-
-
-You can use the dot syntax to access map values from a `Sym` key :
-
-```elixir
-ikc3> a = %{id: 1, title: "My title", message: "Hello, world !"}
-%{id: 1,
-  title: "My title",
-  message: "Hello, world !"}
-ikc3> a.id
-1
-ikc3> a.message
-"Hello, world !"
-```
-
-You can also use the `KC3.access` function for the same result :
-
-```elixir
-ikc3> a = %{id: 1, title: "My title", message: "Hello, world !"}
-%{id: 1,
-  title: "My title",
-  message: "Hello, world !"}
-ikc3> access(a, :id)
-1
-ikc3> access(a, :message)
-"Hello, world !"
-```
-
-To update an existing map you can use Map.put like this :
-
-```elixir
-ikc3> a = %{id: 1, title: "My title"}
-%{id: 1,
-  title: "My title"}
-ikc3> a = Map.put(a, :message, "Hello, world !")
-%{id: 1,
-  title: "My title",
-  message: "Hello, world !"}
-```
-
-
----
-
-Top : [KC3 documentation](/doc/)
-
-Previous : [1.2 Integer](1.2_Integer)
-
-Next : [1.4 Ratio](1.4_Ratio)
diff --git a/doc/1_KC3/1.03_Str.en.md b/doc/1_KC3/1.03_Str.en.md
index 9bc7c43..4bc04af 100644
--- a/doc/1_KC3/1.03_Str.en.md
+++ b/doc/1_KC3/1.03_Str.en.md
@@ -8,10 +8,11 @@ checked according to their size and are NUL terminated.
 
 A string litteral starts and ends with double quotes `"`
 or triple quotes `"""` and inside of a string litteral you can use
-the `#{expr}` syntax to evaluate expr to a Str inside of the litteral.
-The string litteral is then parsed as a `Call` to `KC3.str` and not an
-actual `Str`. At evaluation the arguments to the call and `KC3.str`
-gets called concatenating at once all the parts to a new `Str`.
+the `#{expr}` syntax to evaluate `expr` to a `Str` inside of the
+litteral. The string litteral is then parsed as a `Call` to `KC3.str`
+and not an actual `Str`. At evaluation the arguments to the call
+and `KC3.str` gets called concatenating at once all the parts to a
+brand new `Str`.
 
 ## 1.03.2 Examples
 
diff --git a/doc/1_KC3/1.21_Map.en.md b/doc/1_KC3/1.21_Map.en.md
new file mode 100644
index 0000000..863fdf7
--- /dev/null
+++ b/doc/1_KC3/1.21_Map.en.md
@@ -0,0 +1,71 @@
+# 1.3 Map
+
+KC3 maps are like Elixir maps, they are key-values enclosed in `%{}` :
+
+```elixir
+ikc3> a = %{id: 1, title: "My title", message: "Hello, world !"}
+%{id: 1,
+  title: "My title",
+  message: "Hello, world !"}
+```
+
+Destructuring works with maps to extract values :
+
+```elixir
+ikc3> %{id: id, title: "My title", message: message} = ^ a
+%{id: 1,
+  title: "My title",
+  message: "Hello, world !"}
+ikc3> id
+1
+ikc3> message
+"Hello, world !"
+```
+
+
+You can use the dot syntax to access map values from a `Sym` key :
+
+```elixir
+ikc3> a = %{id: 1, title: "My title", message: "Hello, world !"}
+%{id: 1,
+  title: "My title",
+  message: "Hello, world !"}
+ikc3> a.id
+1
+ikc3> a.message
+"Hello, world !"
+```
+
+You can also use the `KC3.access` function for the same result :
+
+```elixir
+ikc3> a = %{id: 1, title: "My title", message: "Hello, world !"}
+%{id: 1,
+  title: "My title",
+  message: "Hello, world !"}
+ikc3> access(a, :id)
+1
+ikc3> access(a, :message)
+"Hello, world !"
+```
+
+To update an existing map you can use Map.put like this :
+
+```elixir
+ikc3> a = %{id: 1, title: "My title"}
+%{id: 1,
+  title: "My title"}
+ikc3> a = Map.put(a, :message, "Hello, world !")
+%{id: 1,
+  title: "My title",
+  message: "Hello, world !"}
+```
+
+
+---
+
+Top : [KC3 documentation](/doc/)
+
+Previous : [1.2 Integer](1.2_Integer)
+
+Next : [1.4 Ratio](1.4_Ratio)