Inital commit

Author: gaymeowing

content/en-us/luau/index.md

@@ -22,7 +22,6 @@ Luau includes the following data types:
 - [Numbers](numbers.md), or `double`, represent double-precision (64-bit) floating-point numbers.
 - [Strings](strings.md) are sequences of characters, such as letters, numbers, and symbols.
 - [Tables](tables.md) are [arrays](tables.md#arrays) or [dictionaries](tables.md#dictionaries) of any value except `nil`.
-- [Enums](enums.md) are fixed lists of items.
 
 Luau is dynamically typed by default. Variables, function parameters, and return values can be any data type. This helps you write code faster because you don't need to provide types for each piece of data. You can still declare explicit types for variables in Luau and enable [strict type checking](type-checking.md) to make type issues obvious and easy to locate.
 

content/en-us/luau/enums.md renamed to content/en-us/scripting/enums.md

@@ -11,6 +11,7 @@ To get all items of an Enum, call the `GetEnumItems()` method on the enum. The f
 
 ```lua
 local partTypes = Enum.PartType:GetEnumItems()
+
 for index, enumItem in partTypes do
 	print(enumItem)
 end
@@ -34,15 +35,20 @@ Some properties of objects can only be items of certain enums. For example, the
 
 ```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 +58,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,7 +13,7 @@ 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.