Use this link to re-run the recipe: https://app.moderne.io/recipes/org.openrewrite.recipes.rewrite.OpenRewriteRecipeBestPractices?organizationId=QUxML01vZGVybmUvTW9kZXJuZSArIE9wZW5SZXdyaXRl

Co-authored-by: Moderne <team@moderne.io>

* Modernize README to reflect current project capabilities

Update outdated claims (Maven-only support, missing Java 25), restructure
with scannable tables, add Jakarta EE 9/10/11 breadth, and trim obsolete
sections like the Illegal Reflective Access deep-dive.

* Apply suggestions from code review

Co-authored-by: Tim te Beek <timtebeek@gmail.com>

…d. (#1009)

* Add ExplicitTypeToVar recipe to replace explicit type with var keyword.

* Rename ExplicitTypeToVar to UseVarForConstructors.

* Polish

* Additional test cases

---------

Co-authored-by: Tim te Beek <tim@moderne.io>

Use this link to re-run the recipe: https://app.moderne.io/recipes/org.openrewrite.recipes.rewrite.OpenRewriteRecipeBestPractices?organizationId=QUxML01vZGVybmUvTW9kZXJuZSArIE9wZW5SZXdyaXRl

Co-authored-by: Moderne <team@moderne.io>

Use this link to re-run the recipe: https://app.moderne.io/builder/9uwIjLvVE?organizationId=QUxML01vZGVybmUvTW9kZXJuZSArIE9wZW5SZXdyaXRl

Co-authored-by: Moderne <team@moderne.io>

…#1026)

* Extend UseVarForPrimitive to also apply var to String literal variables

* Simplify

* Further simplifications

* Add notes for Faces 4.0 FacesManagedBeansRemoved. #1023

* Update ManagedProperty annotations for Jakarta Faces 4

---------

Co-authored-by: Tim te Beek <tim@moderne.io>

Use this link to re-run the recipe: https://app.moderne.io/recipes/org.openrewrite.recipes.rewrite.OpenRewriteRecipeBestPractices?organizationId=QUxML01vZGVybmUvTW9kZXJuZSArIE9wZW5SZXdyaXRl

Co-authored-by: Moderne <team@moderne.io>

* Add Java best practices recipe

Opinionated recipe that builds on UpgradeToJava25 with additional
best practices: NoGuava, JSpecify, targeted UseVar, and broadly
accepted static analysis improvements.

* Remove recipes already in Java upgrade chain

PrimitiveWrapperClassConstructorToValueOf and
BigDecimalRoundingConstantsToEnums are already included
transitively via Java8toJava11.

* Regenerate recipes.csv for JavaBestPractices

* Add more best practice recipes

Add stdlib preference recipes (UseEnumSetOf, UseListOf, UseSetOf,
UseStringIsEmpty), bug prevention (ReplaceWeekYearWithYear,
RemoveHashCodeCallsFromArrayInstances, RemoveToStringCallsFromArrayInstances,
UseObjectNotifyAll, RemoveCallsToSystemGc, RemoveCallsToObjectFinalize),
and modernization (UseStandardCharset, UseSystemLineSeparator,
RemoveRedundantTypeCast, ReplaceStackWithDeque, UseListSort,
EqualsToContentEquals).

* Remove UseStringIsEmptyRecipe from practices

Removed UseStringIsEmptyRecipe from Java best practices.

* Add ordering comment for UseVar vs UseDiamondOperator

UseVarForGenericsConstructors/UseVarForGenericMethodInvocations
must run before UseDiamondOperator to preserve the explicit type
arguments needed for var inference.

* Add UseVarForConstructors to rewrite rules

* Add UseVarForPrimitive to Java best practices

* Add UseMapOf to Java best practices recipe

Include UseMapOf alongside UseListOf, UseSetOf, and UseEnumSetOf
for consistent coverage of modern collection factory methods.

---------

Co-authored-by: Merlin Bögershausen <merlin.boegershausen@rwth-aachen.de>

* Add JavadocToMarkdownDocComment recipe for JEP 467

Convert traditional Javadoc comments (/** ... */) to Markdown documentation
comments (///) as supported by Java 23+. Transforms HTML constructs like
<pre>, <code>, <em>, <p>, and lists to their Markdown equivalents, and
converts inline tags like {@code} and {@link} to Markdown syntax.

* Add working-set directories to .gitignore

* Update .gitignore to include new patterns

* Address PR review comments on JavadocToMarkdownDocComment

- Remove redundant hasJavadoc early-return check; ListUtils.flatMap
  already returns the same list if nothing changes
- Extract normalizeLines() and toTextComments() helper methods
- Use ListUtils.mapLast() to set the final comment suffix instead of
  manual index tracking

* Slight polish

* Address PR review comments: simplify flatMap, right-trim, and mapLast

* Fix {@literal} and Erroneous handling, add JEP 467 coverage tests

P0 fixes:
- {@literal} content now wrapped in backticks (prevents Markdown
  interpretation of special chars like <T>)
- Erroneous node: use convert() instead of append(getText()) which
  produced List.toString() garbage

P2 tests for existing code paths:
- {@link ref label} form, ordered lists, @exception, @implSpec,
  <i>/<b> tags, @param with inline {@code}, {@docroot}, {@value}

Two tests marked @ExpectedToFail for pre-existing bugs:
- Multi-line {@code}: extra blank lines in fenced code blocks
- @see with qualified names: uses # instead of . for packages

* Group JEP 467 coverage tests in @nested class

Restructure test file per OR conventions:
- Move {@literal} test to core tests (P0 fix validation)
- Wrap remaining coverage tests in @nested Jep467FlagshipExamples
- Remove internal priority-label comments (P0/P2/P3)

---------

Co-authored-by: Merlin Bögershausen <merlin.boegershausen@rwth-aachen.de>

Use this link to re-run the recipe: https://app.moderne.io/recipes/org.openrewrite.java.recipes.ExamplesExtractor?organizationId=QUxML01vZGVybmU%3D

Co-authored-by: Moderne <team@moderne.io>