Update table freezing page

Author: Sainan

docs/New Features/Table Freezing.md

@@ -1,45 +1,46 @@
 ---
 sidebar_position: 2
 ---
-Tables can now be frozen at their current state to forbid any future modification. This action is irreversible and permanent for the lifespan of the table.
+Table freezing irreversibly and permanently forbids any future modifications to a given table.
 
-```pluto showLineNumbers
--- Disallowing any edits to the global environment table.
+Note that table freezing is an optional feature that has to be compiled in by defining the `PLUTO_ENABLE_TABLE_FREEZING` macro in luaconf.h or your build config.
+
+When enabled, it adds the following C APIs:
+- `lua_freezetable(L, idx)`
+- `lua_istablefrozen(L, idx)`
+- `lua_erriffrozen(L, idx)`
+
+and table library functions:
+- `table.isfrozen`
+- `table.freeze`
+
+```pluto norun title="Disallowing any edits to the global environment table"
 table.freeze(_G)
 
-_G.string = {}
--- file.pluto:4: attempt to modify frozen table.
+_G.string = {} -- attempt to modify frozen table.
 ```
-```pluto showLineNumbers
--- Creating a constant local that's associated with a frozen table.
+```pluto norun title="Creating a constant local that's associated with a frozen table"
 local Frozen <const> = table.freeze({ 1, 2, 3 })
 
-Frozen = {}
--- file.pluto:4: attempt to reassign constant.
+Frozen = {} -- attempt to reassign constant.
 
-Frozen[1] = "new value"
--- file.pluto:7: attempt to modify frozen table.
+Frozen[1] = "new value" -- attempt to modify frozen table.
 
-rawset(Frozen, "key", "value")
--- file.pluto:10: attempt to modify frozen table.
+rawset(Frozen, "key", "value") -- attempt to modify frozen table.
 ```
-```pluto showLineNumbers
---- Trying to swap the value with the debug library.
+```pluto norun title="Trying to swap the value with the debug library"
+local Frozen <const> = table.freeze({ 1, 2, 3 })
 for i = 1, 249 do
   local name, value = debug.getlocal(1, i)
   if name == "Frozen" then
-    debug.setlocal(1, i, { ["key"] = "hello world" })
-    -- file.pluto:5: attempt to modify local variable with a frozen table.
+    debug.setlocal(1, i, { ["key"] = "hello world" }) -- attempt to modify local variable with a frozen table.
   end
 end
 ```
+
 ### What will this prevent?
 All modifications to the table from within the Lua environment will be prevented, including those from the `debug` library.
 
 :::caution
 If you're going to use this for a sandbox, ensure you call `table.freeze` before any users can access the Lua environment, otherwise they can replace that function.
 :::
-
-:::info
-As of Pluto 0.11.0, these functions are unavailable by default. You can enable them by defining the `PLUTO_ENABLE_TABLE_FREEZING` macro.
-:::