Wizards of Lua

Docs: Class Section Formatting
Updated all API docs so that each class description appears above the ---@class tag, in accordance with our documentation standards.

Docs: Field Documentation Reviewed

• Reviewed and revised documentation for every field to clearly indicate whether accessing it returns a reference or a copy.
• Added missing @Read-Only tags for all immutable properties.

Docs: Example Code
Added more illustrative code snippets throughout the API docs to demonstrate common usage patterns and clarify behavior.

Note: Run /wol extract-api to update the config/wizards-of-lua/api folder with the latest API documentation.