From f42016a4d86d82160d7956da6921522cf76b7e42 Mon Sep 17 00:00:00 2001
From: Zamiell <5511220+Zamiell@users.noreply.github.com>
Date: Fri, 21 May 2021 10:28:04 -0400
Subject: [PATCH 1/2] iterating over LuaTable

---
 docs/advanced/language-extensions.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/advanced/language-extensions.md b/docs/advanced/language-extensions.md
index 3f4e9aea..1321468f 100644
--- a/docs/advanced/language-extensions.md
+++ b/docs/advanced/language-extensions.md
@@ -230,6 +230,8 @@ You can also map functions to table accessors (`__index` and `__newindex`). See
 
 ## Lua Table Types
 
+### Getting and Setting
+
 The `LuaTable` type is provided to allow direct creation and manipulation of Lua tables. This is useful if you want to use a table that uses types other than string for its keys, as that is not supported by Typescript. Calls to `get` and `set` on the table will transpile directly to `value = table[key]` and `table[key] = value`.
 
 Example:
@@ -266,12 +268,35 @@ print(#tbl)
 
 </SideBySide>
 
+### Iterating
+
+To iterate over a `LuaTable`, use `pairs()`. (This requires the `lua-types` library to be installed.)
+
+```ts
+const tbl = new LuaTable();
+
+tbl.set(3, "bar");
+tbl.set(4, "bar");
+tbl.set(5, "bar");
+
+for (const [key, value] of pairs(tbl)) {
+  print(key)
+  print(value)
+}
+```
+
+(Remember that in Lua, `pairs()` returns the keys in a random order.)
+
+### Restricting the Types
+
 `LuaTable` can also be restricted to use only certain types as keys and values:
 
 ```ts
 const tbl = new LuaTable<KeyType, ValueType>();
 ```
 
+### Custom Getters and Setters
+
 If you have a type that uses non-string keys, you can use `LuaTableGet` and `LuaTableSet` function types to declare your own getters & setters, similar to [Operator Map Types](#operator-map-types).
 
 Example:

From 44e8c5ce5a2439bacc68e5e9c842995dd42e7cb7 Mon Sep 17 00:00:00 2001
From: Zamiell <5511220+Zamiell@users.noreply.github.com>
Date: Fri, 21 May 2021 21:57:27 -0400
Subject: [PATCH 2/2] fixing linter

---
 docs/advanced/language-extensions.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/advanced/language-extensions.md b/docs/advanced/language-extensions.md
index 1321468f..5c1bc90e 100644
--- a/docs/advanced/language-extensions.md
+++ b/docs/advanced/language-extensions.md
@@ -280,8 +280,8 @@ tbl.set(4, "bar");
 tbl.set(5, "bar");
 
 for (const [key, value] of pairs(tbl)) {
-  print(key)
-  print(value)
+  print(key);
+  print(value);
 }
 ```