Skip to content

Documentation - #7906

Merged
mernst merged 2 commits into
typetools:masterfrom
mernst:doc-for-modifiability
Aug 2, 2026
Merged

Documentation#7906
mernst merged 2 commits into
typetools:masterfrom
mernst:doc-for-modifiability

Conversation

@mernst

@mernst mernst commented Aug 1, 2026

Copy link
Copy Markdown
Member

No description provided.

@coderabbitai

coderabbitai Bot commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 45910d06-4a8b-4e3b-9c17-11682e1e30d8

📥 Commits

Reviewing files that changed from the base of the PR and between 5f121c7 and 534fb69.

📒 Files selected for processing (3)
  • annotation-file-utilities/src/main/java/org/checkerframework/afu/scenelib/el/AClass.java
  • checker/bin-devel/count-suppression-reasons
  • checker/src/main/java/org/checkerframework/checker/initialization/InitializationVisitor.java

📝 Walkthrough

Walkthrough

Updated documentation comments across annotation utilities, checker visitors, command-line help, and the manual. Added Javadoc for private array conversion helpers. Clarified constructor-result annotation requirements, constructor receiver notes, enum constructor wording, suppression-reason option behavior, and Oracle Javadoc reference escaping rules. No executable behavior or public declarations changed.

Possibly related PRs

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (2 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
`@annotation-file-utilities/src/main/java/org/checkerframework/afu/scenelib/el/AClass.java`:
- Around line 24-25: Update the Javadoc for the AClass.extendsImplements field
to describe non-negative TypeIndexLocation values as identifying implemented or
extended interfaces, while retaining the existing -1 superclass mapping.

In `@checker/bin-devel/count-suppression-reasons`:
- Line 12: Update the -y option description in count-suppression-reasons to
identify it as the second exclusion filter, and clarify that -x and -y together
provide two exclusion patterns while -y itself accepts one grep -v pattern.

In
`@checker/src/main/java/org/checkerframework/checker/initialization/InitializationVisitor.java`:
- Line 90: Reword the TODO in InitializationVisitor to refer specifically to
non-static inner classes rather than nested classes, making clear that their
constructors can have receiver parameters and avoiding inclusion of static
nested classes.

In `@docs/manual/manual-style.tex`:
- Around line 174-176: Update the documentation comments for the Javadoc macros
so the \url restriction applies specifically to the second argument of
\sunjavadoc and \sunjavadocanno, rather than to the body of any macro; preserve
the existing guidance for the other arguments.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: db0e9544-4eac-4c4a-a860-91865dfc2204

📥 Commits

Reviewing files that changed from the base of the PR and between eed57ea and 5f121c7.

📒 Files selected for processing (8)
  • annotation-file-utilities/src/main/java/org/checkerframework/afu/scenelib/el/AClass.java
  • checker-qual/src/main/java/org/checkerframework/checker/formatter/qual/ConversionCategory.java
  • checker-qual/src/main/java/org/checkerframework/checker/i18nformatter/qual/I18nConversionCategory.java
  • checker/bin-devel/count-suppression-reasons
  • checker/src/main/java/org/checkerframework/checker/initialization/InitializationVisitor.java
  • checker/src/main/java/org/checkerframework/checker/interning/InterningVisitor.java
  • docs/manual/manual-style.tex
  • javacutil/src/main/java/org/checkerframework/javacutil/AnnotationUtils.java

Comment thread checker/bin-devel/count-suppression-reasons Outdated
Comment thread docs/manual/manual-style.tex
@mernst
mernst merged commit fb5743c into typetools:master Aug 2, 2026
39 checks passed
@mernst
mernst deleted the doc-for-modifiability branch August 2, 2026 00:24
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.

1 participant