Skip to content

Convert Javadoc comments to Markdown - #38

Merged
manoelcampos merged 2 commits into
masterfrom
markdown-javadocs
Oct 20, 2026
Merged

manoelcampos merged 2 commits into
masterfrom
markdown-javadocs

Conversation

@manoelcampos

Copy link
Copy Markdown
Contributor

Changes

  • Converts all Javadoc comments (/** */) to Markdown documentation comments (///, JEP 467, supported since JDK 23):
    • HTML tags (<p>, <b>, <i>, <code>, <pre>, <ul>/<ol>/<li>, <a href>) converted to Markdown;
    • {@code x} converted to `x` and {@link X label} to [label][X];
    • block tags (@param, @return, @see...) and other inline tags ({@inheritDoc}, {@return}...) kept, since they're supported in Markdown comments.
  • Adds the missing license header to CloudSim Plus package-info.java files.

Verification

  • mvn clean verify passing.
  • doclint before/after: 1 → 0 errors, 2 → 2 warnings (pre-existing).

🤖 Generated with Claude Code

manoelcampos and others added 2 commits October 20, 2026 07:46
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Javadoc comments (/** */) were converted to Markdown documentation
comments (///), supported since JDK 23:

- HTML tags (<p>, <b>, <i>, <code>, <pre>, <ul>/<ol>/<li>, <a href>)
  converted to Markdown;
- {@code x} converted to `x` and {@link X label} to [label][X];
- block tags (@PARAM, @return, @see...) and other inline tags
  ({@inheritdoc}, {@return}...) kept, since they're supported.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@manoelcampos manoelcampos self-assigned this Oct 20, 2026
@manoelcampos
manoelcampos merged commit 39b119e into master Oct 20, 2026
1 check failed
@manoelcampos
manoelcampos deleted the markdown-javadocs branch October 20, 2026 10:59
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