Skip to content

Address recurring AI review findings in policy and agent snippets - #774

Merged
kesselb merged 1 commit into
masterfrom
docs/noid/ai-policy--code-quality-refinement
Aug 10, 2026
Merged

Address recurring AI review findings in policy and agent snippets#774
kesselb merged 1 commit into
masterfrom
docs/noid/ai-policy--code-quality-refinement

Conversation

@AndyScherzinger

Copy link
Copy Markdown
Member

Incorporate the code comment conventions from nextcloud/notes#1982 and generalize recurring review feedback on AI-assisted PRs:

  • Code comments must document the code, never the process that produced it; keep them brief and matching surrounding density
  • Reuse existing helpers instead of duplicating logic, and fix every occurrence of a flawed pattern
  • Run permission/access-control checks before the guarded operation
  • Wire up and test features in every reachable context (public shares, Smart Picker/reference widgets), not only the default authenticated view
  • Remove malformed/garbled characters from generated output

Assisted-by: Claude Code:claude-fable-5

🤖 AI (if applicable)

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

Incorporate the code comment conventions from nextcloud/notes#1982 and
generalize recurring review feedback on AI-assisted PRs:

- Code comments must document the code, never the process that
  produced it; keep them brief and matching surrounding density
- Reuse existing helpers instead of duplicating logic, and fix every
  occurrence of a flawed pattern
- Run permission/access-control checks before the guarded operation
- Wire up and test features in every reachable context (public
  shares, Smart Picker/reference widgets), not only the default
  authenticated view
- Remove malformed/garbled characters from generated output

Assisted-by: Claude Code:claude-fable-5
Signed-off-by: Andy Scherzinger <info@andy-scherzinger.de>
@AndyScherzinger AndyScherzinger added 3. to review Waiting for reviews documentation Improvements or additions to documentation AI assisted This PR contains AI-assisted commits labels Aug 10, 2026
@kesselb
kesselb merged commit c009c81 into master Aug 10, 2026
6 checks passed
@kesselb
kesselb deleted the docs/noid/ai-policy--code-quality-refinement branch August 10, 2026 12:28
AndyScherzinger added a commit to nextcloud/files_mindmap that referenced this pull request Aug 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3. to review Waiting for reviews AI assisted This PR contains AI-assisted commits documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants