Remove Enum from Luau Reference section

content/en-us/luau/enums.md

@@ -3,14 +3,19 @@ title: Enums
 description: A fixed list of items (enumeration).
 ---
 
-The **enumeration** data type, or `Datatype.Enum`, is a fixed list of items. You can access enums through the global object called `Datatype.Enum`. For a full list of Enums and their items, see [Enums](/reference/engine/enums) in the API Reference.
+<Alert severity="info">
+Enums are not a [built-in Luau type](https://luau.org/typecheck#builtin-types) and they exist only in Roblox, but they're conceptually similar to other Luau data types and are something you'll work with frequently in Roblox development.
+</Alert>
 
-## Get enum items
+The **enumeration** data type, or `Datatype.Enum`, is a fixed list of items. You can access enums through the global object called `Datatype.Enum`. For a full list and their respective items, see [Enums](/reference/engine/enums).
 
-To get all items of an Enum, call the `GetEnumItems()` method on the enum. The following code sample demonstrates how to call `GetEnumItems()` on the `Enum.PartType` enum.
+## Enum items
+
+To get all items of an enum, call the `Datatype.Enum:GetEnumItems()|GetEnumItems()` method on it. The following code sample demonstrates how to call `Datatype.Enum:GetEnumItems()|GetEnumItems()` on the `Enum.PartType` enum.
 
 ```lua
 local partTypes = Enum.PartType:GetEnumItems()
+
 for index, enumItem in partTypes do
 	print(enumItem)
 end
@@ -19,30 +24,34 @@ end
 	Enum.PartType.Ball
 	Enum.PartType.Block
 	Enum.PartType.Cylinder
+	Enum.PartType.Wedge
+	Enum.PartType.CornerWedge
 ]]
 ```
 
 ## Data type
 
 The `Datatype.EnumItem` is the data type for items in enums. An `Datatype.EnumItem` has three properties:
 
-- `Name` - The name of the `Datatype.EnumItem`.
-- `Value` - The numerical index of the `Datatype.EnumItem`.
-- `EnumType` - The parent `Datatype.Enum` of the `Datatype.EnumItem`.
+- `Name` — The name of the `Datatype.EnumItem`.
+- `Value` — The numerical index of the `Datatype.EnumItem`.
+- `EnumType` — The parent `Datatype.Enum` of the `Datatype.EnumItem`.
 
-Some properties of objects can only be items of certain enums. For example, the `Shape` property of a `Class.Part` object is an item of the `Enum.PartType` Enum. The following code sample demonstrates how to print the properties of the `Enum.PartType.Cylinder` EnumItem.
+Some properties of objects can only be items of certain enums. For example, the `Class.Part.Shape|Shape` property of a `Class.Part` object is an item of the `Enum.PartType` enum. The following code sample demonstrates how to print the properties of the `Enum.PartType.Cylinder` enum item.
 
 ```lua
--- Properties of the EnumItem called Enum.PartType.Cylinder
-print(Enum.PartType.Cylinder.Name) -- Cylinder
-print(Enum.PartType.Cylinder.Value) -- 2
-print(Enum.PartType.Cylinder.EnumType) -- PartType
+print(Enum.PartType.Cylinder.Name) --> "Cylinder"
+print(Enum.PartType.Cylinder.Value) --> 2
+print(Enum.PartType.Cylinder.EnumType) --> PartType
 ```
 
-## Assign enum items
-
 To assign an `Datatype.EnumItem` as the value of a property, use the full `Datatype.Enum` declaration. You can also use its `Value` or `EnumType`.
 
+<Alert severity="warning">
+Assigning `Datatype.EnumItem` properties like `Class.Part.Shape|Shape` to the `DataType.EnumItem.Value|Value` property is bad practice, as the `DataType.EnumItem.Value|Value` property can be moved around if a new `Datatype.EnumItem` is added to the `Enum.PartType` enum.
+Meaning your code may break if you rely on assigning `Datatype.EnumItem` via their `DataType.EnumItem.Value|Value`.
+</Alert>
+
 ```lua
 local Workspace = game:GetService("Workspace")
 
@@ -52,6 +61,5 @@ part.Shape = Enum.PartType.Cylinder.Value -- By EnumItem Value
 part.Shape = 2  -- By EnumItem Value
 part.Shape = Enum.PartType.Cylinder.Name -- By EnumItem Name
 part.Shape = "Cylinder"  -- By EnumItem Name
-
 part.Parent = Workspace
 ```

content/en-us/scripting/index.md

@@ -13,12 +13,12 @@ If you've never written code before and want an introduction to programming, see
 
 ## Luau
 
-Roblox scripts use the [Luau](https://luau-lang.org) programming language, which is derived from [Lua 5.1](https://www.lua.org/manual/5.1/).
+Roblox scripts use the [Luau](https://luau.org) programming language, which is derived from [Lua 5.1](https://www.lua.org/manual/5.1/).
 
 - Compared to Lua 5.1, Luau adds performance enhancements and many useful features, including an optional typing system, string interpolation, and generalized iteration for tables.
 - All valid Lua 5.1 code is valid Luau code, but the opposite is not true.
 
-Most books and online resources for Lua are still broadly applicable to Luau. For a detailed summary of differences, see [Compatibility](https://luau-lang.org/compatibility) in the Luau documentation. For language syntax, see the [Luau reference](../luau/index.md).
+Most books and online resources for Lua are still broadly applicable to Luau. For a detailed summary of differences, see [Compatibility](https://luau.org/compatibility) in the Luau documentation. For language syntax, see the [Luau reference](../luau/index.md).
 
 ### Luau basics