Skip to content

fix: fix javadoc warning in ShoppingCart test example#556

Merged
He-Pin merged 2 commits into
apache:mainfrom
He-Pin:fix/javadoc-warnings
Jul 6, 2026
Merged

fix: fix javadoc warning in ShoppingCart test example#556
He-Pin merged 2 commits into
apache:mainfrom
He-Pin:fix/javadoc-warnings

Conversation

@He-Pin

@He-Pin He-Pin commented Jul 4, 2026

Copy link
Copy Markdown
Member

Motivation

Javadoc warning in examples/src/test/java/jdocs/eventsourced/ShoppingCart.java:

  • {@link Summary} and {@link Confirmation} cannot be resolved because they are inner classes of ShoppingCart and need the enclosing class prefix

Modification

  • Replace {@link Summary} with {@link ShoppingCart.Summary}
  • Replace {@link Confirmation} with {@link ShoppingCart.Confirmation}

Result

Javadoc warning is eliminated.

Tests

Not run - docs only

References

None

He-Pin added 2 commits July 4, 2026 16:26
Motivation:
Javadoc warning: `{@link Summary}` cannot be resolved because `Summary`
is an inner class of `ShoppingCart` and needs the enclosing class prefix.

Modification:
- Replace `{@link Summary}` with `{@link ShoppingCart.Summary}`
- Replace `{@link Confirmation}` with `{@link ShoppingCart.Confirmation}`

Result:
Javadoc warning is eliminated.

Tests:
Not run - docs only

References:
None
Motivation:
CI javafmtCheck fails on the javadoc warnings PR due to unformatted Java files.

Modification:
Run sbt javafmt to auto-format all Java source files.

Result:
CI javafmtCheck should now pass.
@He-Pin He-Pin requested a review from pjfanning July 4, 2026 14:32

@pjfanning pjfanning left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

lgtm

@He-Pin He-Pin merged commit 197bf5d into apache:main Jul 6, 2026
21 checks passed
@He-Pin He-Pin deleted the fix/javadoc-warnings branch July 6, 2026 14:25
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.

2 participants