Skip to content

[8.2] Resolve javac warnings in perc-polls-services module #2042

Description

@vijaya-boddipudi

Description
The perc-polls-services module currently completes its build successfully, but still reports Java compiler (javac) and/or Javadoc source warnings that should be cleaned up to improve code quality and maintain a warning-free build.

Cleaning these issues will improve API documentation consistency and help maintain overall code quality.

Module

perc-polls-services

Build Summary

  • Module: perc-polls-services
  • Build Status: SUCCESS
  • Reactor Index: 42
  • Total Diagnostics: 4
  • Javac Warnings: 4 (unique: 4)
  • Javac Errors: 0
  • Javadoc Warnings: 0
  • Javadoc Errors: 0
  • Analysis Warnings: 0
  • Analysis Errors: 0

Expected Result

  • The module should build without any javac or javadoc warnings or errors.
  • All source files should compile cleanly under JDK 21 with the project's -Xlint:all settings.
  • Public classes, interfaces, methods, constructors, fields, and parameters should contain complete and valid Javadoc.

Javadoc generation should complete cleanly without warnings.

Actual Result

The module builds with status SUCCESS, but 4 diagnostic message(s) are reported during compilation.

Acceptance Criteria

  • Resolve all javac and javadoc warnings in the perc-polls-services module.
  • Ensure all public APIs have complete and valid Javadoc.
  • Verify the module builds successfully with zero javac errors, zero javadoc errors, and zero javadoc warnings.
  • Confirm no regressions are introduced during cleanup.

Documents to refer and follow:
java-api-writing-specs.md
javadoc-checklist.md
javadoc-spec-summary.md
javadoc-tool-architecture.md
javadoc-tool-comments.md

Activity

  1. added this to the 8.2 milestone on Aug 5, 2026
  2. vijaya-boddipudi commented on Aug 6, 2026

    @vijaya-boddipudi
    CollaboratorAuthor

    Status update (2026-08-06): The original PR for this issue (#2054) used @SuppressWarnings annotations to silence the warnings. Per the team's current strategy, those suppressions are being replaced with real fixes — parameterising raw collections (List → List<T>), qualifying static method calls by class name, and removing redundant casts. The original PR has already been merged, so this issue is being reopened and a follow-up fix/rawtypes PR will be opened shortly to complete the actual remediation.

  3. removed their assignment
    on Aug 7, 2026
  4. natechadwick-intsof commented on Aug 7, 2026

    @natechadwick-intsof
    Collaborator

    Agent progress: Claiming for overnight implement (night-issue-prs).

    Scope: resolve 4 javac warnings in perc-polls-services (deliverytiersuite/delivery-tier-suite/polls). Parent tracker: #2200.

    Co-Authored by Grok Build using grok-4.5 with agent main.

  5. natechadwick-intsof commented on Aug 7, 2026

    @natechadwick-intsof
    Collaborator

    PR opened: #2302

    Real-fix replacement for suppress-only #2054:

    • PSPollsApplication is final (this-escape)
    • Removed Serializable from PSPoll / PSPollAnswer / IPSPollAnswer (serial lint without breaking Hibernate Set mapping)

    Module mvnw clean install: 8 tests, 0 failures, 0 javac warnings.

    Co-Authored by Grok Build using grok-4.5 with agent main.

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

Metadata

Metadata

Labels

8.2This issue found in 8.2 releasetech-debttech debt

Type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions