Skip to content

docs(agents): update for adding unnecessary comments - #17468

Merged
alperozturk96 merged 4 commits into
masterfrom
docs/agent-comment-guidelines
Aug 13, 2026
Merged

docs(agents): update for adding unnecessary comments#17468
alperozturk96 merged 4 commits into
masterfrom
docs/agent-comment-guidelines

Conversation

@alperozturk96

@alperozturk96 alperozturk96 commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

馃 AI (if applicable)

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

Signed-off-by: alperozturk96 <alper_ozturk@proton.me>
Replace the single-line comment rule with a dedicated Comments section
stating that names carry the explanation, when a comment is warranted,
and an explicit never-list. Comments must not narrate the change or
reference the issue, PR or the conversation that produced it.

Apply the same rule to the java-to-kotlin skill conventions.

Assisted-by: ClaudeCode:claude-opus-5
@alperozturk96 alperozturk96 changed the title Docs/agent comment guidelines docs(agents): tighten comment guidance for AI contributions Aug 13, 2026
Signed-off-by: alperozturk96 <alper_ozturk@proton.me>
Signed-off-by: alperozturk96 <alper_ozturk@proton.me>
@alperozturk96 alperozturk96 changed the title docs(agents): tighten comment guidance for AI contributions docs(agents): update for adding unnecessary comments Aug 13, 2026
@github-actions

Copy link
Copy Markdown

blue-Light-Screenshot test failed, but no output was generated. Maybe a preliminary stage failed.

@github-actions

Copy link
Copy Markdown

Codacy

SpotBugs

CategoryBaseNew
Bad practice3232
Correctness6060
Dodgy code214214
Experimental11
Malicious code vulnerability22
Multithreaded correctness2525
Performance4040
Security1919
Total393393

@alperozturk96
alperozturk96 merged commit b984f57 into master Aug 13, 2026
19 of 23 checks passed
@alperozturk96
alperozturk96 deleted the docs/agent-comment-guidelines branch August 13, 2026 08:34
@github-actions

Copy link
Copy Markdown

APK file: https://github.com/nextcloud/android/actions/runs/31681588421/artifacts/9174137383
To test this change/fix you can simply download above APK file and install and test it in parallel to your existing Nextcloud app.
qrcode (please click on link to get QR code displayed)

@github-actions

Copy link
Copy Markdown

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants