Skip to content

feat: Add Gradle task to check auto-import documentation sync#7782

Draft
margaretkennedy wants to merge 1 commit intodeephaven:mainfrom
margaretkennedy:autoimport-gradle-check
Draft

feat: Add Gradle task to check auto-import documentation sync#7782
margaretkennedy wants to merge 1 commit intodeephaven:mainfrom
margaretkennedy:autoimport-gradle-check

Conversation

@margaretkennedy
Copy link
Contributor

Adds checkAutoImportDocs task to engine-table that:

  • Uses Java reflection to extract methods from QueryLibraryImportsDefaults.statics()
  • Parses markdown docs to find documented methods
  • Compares and reports any mismatches
  • Fails build if methods are missing from docs

Usage: ./gradlew :engine-table:checkAutoImportDocs

This is lightweight and can be added to pre-merge checks.

Currently: You must run the task manually
Future options:
Add check.dependsOn(checkAutoImportDocs) → runs with every ./gradlew check
Add to CI workflow → runs on every PR

Adds checkAutoImportDocs task to engine-table that:
- Uses Java reflection to extract methods from QueryLibraryImportsDefaults.statics()
- Parses markdown docs to find documented methods
- Compares and reports any mismatches
- Fails build if methods are missing from docs

Usage: ./gradlew :engine-table:checkAutoImportDocs

This is lightweight and can be added to pre-merge checks.
@margaretkennedy margaretkennedy added documentation Improvements or additions to documentation NoDocumentationNeeded NoReleaseNotesNeeded No release notes are needed. labels Mar 11, 2026
@github-actions
Copy link
Contributor

No docs changes detected for bd4e9f7

@margaretkennedy margaretkennedy marked this pull request as draft March 11, 2026 17:35
@margaretkennedy margaretkennedy changed the title WIP feat: Add Gradle task to check auto-import documentation sync feat: Add Gradle task to check auto-import documentation sync Mar 11, 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 NoDocumentationNeeded NoReleaseNotesNeeded No release notes are needed.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant