Skip to content

refactor(Template): clarify JSConfigHelper naming, comments, and docblocks#61050

Draft
joshtrichards wants to merge 6 commits into
masterfrom
jtr/refactor-JSConfigHelper
Draft

refactor(Template): clarify JSConfigHelper naming, comments, and docblocks#61050
joshtrichards wants to merge 6 commits into
masterfrom
jtr/refactor-JSConfigHelper

Conversation

@joshtrichards
Copy link
Copy Markdown
Member

@joshtrichards joshtrichards commented Jun 6, 2026

Summary

I'm working on some other changes in this class, but figured I'd submit these easier to review changes first.

This PR aims to improve readability of JSConfigHelper by clarifying naming, comments, and docblocks. It also adds basic unit test coverage.

Specific changes:

  • Adds class docblock
  • Adds key function docblocks
  • Renames variables for improved clarity
  • Replaces vague comments
  • Adds clarifying comments in key spots
  • Makes injected services private readonly

TODO

  • Review and ahem test AI generated tests

Anybody know why canUserValidatePassword() is protected rather than private?

Checklist

AI (if applicable)

  • The content of this PR was partly or fully generated using AI

- Add class docblock
- Add key function docblocks
- Rename variables for improved clarity
- Replace vague comments
- Add key clarifying comments

Signed-off-by: Josh <josh.t.richards@gmail.com>
Signed-off-by: Josh <josh.t.richards@gmail.com>
Signed-off-by: Josh <josh.t.richards@gmail.com>
Signed-off-by: Josh <josh.t.richards@gmail.com>
@joshtrichards joshtrichards added 2. developing Work in progress feature: templates php Pull requests that update Php code ♻️ refactor Refactor code (not a bug fix, not a feature just refactoring) tests Related to tests labels Jun 6, 2026
@joshtrichards joshtrichards added this to the Nextcloud 35 milestone Jun 6, 2026
Signed-off-by: Josh <josh.t.richards@gmail.com>
Signed-off-by: Josh <josh.t.richards@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

2. developing Work in progress feature: templates php Pull requests that update Php code ♻️ refactor Refactor code (not a bug fix, not a feature just refactoring) tests Related to tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant