Skip to content

Add LDoc annotations for public PIXEL API surface - #64

Merged
TomDotBat merged 9 commits into
masterfrom
copilot/docs-create-wiki-entry
May 14, 2026
Merged

Add LDoc annotations for public PIXEL API surface#64
TomDotBat merged 9 commits into
masterfrom
copilot/docs-create-wiki-entry

Conversation

Copilot AI commented May 14, 2026

Copy link
Copy Markdown
Contributor
  • Confirm current lint path and baseline status before new edits
  • Add LDoc method annotations (descriptions + params/returns) for public-facing panel APIs in elements/ and menus/
  • Run available validation command(s) after updates
  • Address review feedback from automated validation
  • Commit and push documentation updates

Copilot AI linked an issue May 14, 2026 that may be closed by this pull request
Agent-Logs-Url: https://github.com/TomDotBat/pixel-ui/sessions/d8703e3b-98fa-499f-ac85-1b39e8e6c91c

Co-authored-by: TomDotBat <11298466+TomDotBat@users.noreply.github.com>
Copilot AI changed the title [WIP] Create documentation for public methods in the codebase Add LDoc annotations for public PIXEL API surface May 14, 2026
Copilot AI requested a review from TomDotBat May 14, 2026 09:31

@TomDotBat TomDotBat left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add descriptions to all parameters and returns, also document all registered panels

Comment thread lua/autorun/sh_pixelui_loader.lua Outdated
PIXEL.UI = PIXEL.UI or {}
PIXEL.UI.Version = "1.4.1"

--- Loads all Lua files in a directory, applying client/server include rules.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

State what the realm rules are

Comment thread lua/autorun/sh_pixelui_loader.lua Outdated
return files, folders
end

--- Recursively loads Lua files in a directory and its subfolders.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mention the realm rules

Comment thread lua/pixelui/core/cl_color.lua Outdated
end
end

--- Returns a new Color copy.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Returns a new instance of a Colour with the same values.

Agent-Logs-Url: https://github.com/TomDotBat/pixel-ui/sessions/67763ae5-257a-43e2-9a05-640f338eac18

Co-authored-by: TomDotBat <11298466+TomDotBat@users.noreply.github.com>
@TomDotBat

Copy link
Copy Markdown
Owner

@copilot continue work pls

Agent-Logs-Url: https://github.com/TomDotBat/pixel-ui/sessions/4a3f6d2a-418b-48e8-925b-7cade7a95b51

Co-authored-by: TomDotBat <11298466+TomDotBat@users.noreply.github.com>

Copilot AI commented May 14, 2026

Copy link
Copy Markdown
Contributor Author

@copilot continue work pls

Pushed b6610e7 with LDoc class documentation for all registered PIXEL panels and completed parameter/return descriptions.

Copilot AI and others added 3 commits May 14, 2026 16:43
Agent-Logs-Url: https://github.com/TomDotBat/pixel-ui/sessions/295cda3c-e817-48e1-9a7d-fbb7fd86f7c1

Co-authored-by: TomDotBat <11298466+TomDotBat@users.noreply.github.com>
Agent-Logs-Url: https://github.com/TomDotBat/pixel-ui/sessions/295cda3c-e817-48e1-9a7d-fbb7fd86f7c1

Co-authored-by: TomDotBat <11298466+TomDotBat@users.noreply.github.com>
Agent-Logs-Url: https://github.com/TomDotBat/pixel-ui/sessions/295cda3c-e817-48e1-9a7d-fbb7fd86f7c1

Co-authored-by: TomDotBat <11298466+TomDotBat@users.noreply.github.com>

@TomDotBat TomDotBat left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still missing a bunch of critical methods on a several panels, they need to be documented

Copilot AI and others added 2 commits May 14, 2026 21:25
Agent-Logs-Url: https://github.com/TomDotBat/pixel-ui/sessions/54fb10ca-5f6d-4486-a95a-474ac8b99ce9

Co-authored-by: TomDotBat <11298466+TomDotBat@users.noreply.github.com>
Agent-Logs-Url: https://github.com/TomDotBat/pixel-ui/sessions/54fb10ca-5f6d-4486-a95a-474ac8b99ce9

Co-authored-by: TomDotBat <11298466+TomDotBat@users.noreply.github.com>

Copilot AI commented May 14, 2026

Copy link
Copy Markdown
Contributor Author

Still missing a bunch of critical methods on a several panels, they need to be documented

Done — I added LDoc docs for the remaining critical panel methods across the core element panels (including params/returns), then pushed a follow-up fix for callback forwarding in text entry internals. Addressed in e44aa64 (docs in 5044bd8).

Copilot AI requested a review from TomDotBat May 14, 2026 21:27
@TomDotBat
TomDotBat marked this pull request as ready for review May 14, 2026 21:39
Copilot AI review requested due to automatic review settings May 14, 2026 21:39
@TomDotBat
TomDotBat merged commit 1d8321f into master May 14, 2026
2 of 3 checks passed
@TomDotBat
TomDotBat deleted the copilot/docs-create-wiki-entry branch May 14, 2026 21:40

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: create documentation

3 participants