Skip to content

Include generated Gradle plugin documentation#485

Merged
timtebeek merged 4 commits intomasterfrom
tim/gradle-plugin-docs
Apr 13, 2026
Merged

Include generated Gradle plugin documentation#485
timtebeek merged 4 commits intomasterfrom
tim/gradle-plugin-docs

Conversation

@timtebeek
Copy link
Copy Markdown
Member

@timtebeek timtebeek commented Apr 11, 2026

Summary

  • Replace hand-written bullet-list property descriptions with a comprehensive table sourced from the generated plugin reference

  • Add coverage for previously undocumented properties: checkstyleConfigFile, enableExperimentalGradleBuildScriptParsing, failOnInvalidActiveRecipes, logCompilationWarningsAndErrors, throwOnParseFailures, rewriteVersion

  • Add link to the auto-generated Javadoc

  • Closes Include the generated Gradle plugin documentation #484

Test plan

  • npm run build succeeds
  • Review rendered table on the docs site

Replace the hand-written bullet-list property descriptions with the
comprehensive table generated from Javadoc, adding coverage for
previously undocumented properties (checkstyleConfigFile,
enableExperimentalGradleBuildScriptParsing, failOnInvalidActiveRecipes,
logCompilationWarningsAndErrors, throwOnParseFailures, rewriteVersion).
Also add a link to the auto-generated Javadoc.

Closes #484
Add a Python script that fetches the generated properties table from
rewrite-gradle-plugin's docs/plugin-reference.md and replaces the
content between markers in gradle-plugin-configuration.md. Integrate
this into the existing update-docs workflow so it runs on every
scheduled or manual update.
@timtebeek timtebeek requested a review from mike-solomon April 11, 2026 23:32
@timtebeek timtebeek added the documentation Improvements or additions to documentation label Apr 11, 2026
Copy link
Copy Markdown
Contributor

@mike-solomon mike-solomon left a comment

Choose a reason for hiding this comment

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

Nice! This looks great.

@github-project-automation github-project-automation bot moved this from In Progress to Ready to Review in OpenRewrite Apr 13, 2026
@timtebeek timtebeek merged commit a102ffb into master Apr 13, 2026
2 checks passed
@timtebeek timtebeek deleted the tim/gradle-plugin-docs branch April 13, 2026 15:35
@github-project-automation github-project-automation bot moved this from Ready to Review to Done in OpenRewrite Apr 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

Include the generated Gradle plugin documentation

2 participants