Skip to content

Conversation

@andrueastman
Copy link
Contributor

@andrueastman andrueastman commented Feb 27, 2025

fixes microsoftgraph/msgraph-sdk-java#2078
fixes microsoftgraph/msgraph-sdk-java#1893

This PR includes the following changes.

  • enables the javadoc task to ensure that javadocs are part of release task artifacts
  • adds a step in CI/CD stages to move sources in the /generated folder up one folder so that the generated sources are in the correct package structure

Considerations.
As much as updating the generation pipeline to place the generated files in the correct package structure is a good idea, we have a number of hand writter files in the root path such as microsoftgraph/msgraph-sdk-java#2298 that would be overwritten or replaced. The alternative would involve keeping a record of handwritten files and moving them just in time but that would increase the maintenance burden.

Microsoft Reviewers: Open in CodeFlow

baywet
baywet previously approved these changes Feb 27, 2025
baywet
baywet previously approved these changes Feb 27, 2025
@andrueastman andrueastman force-pushed the andrueastman/fixjavaDocs branch from 0e0c1d5 to 1a633b6 Compare February 27, 2025 14:14
@andrueastman
Copy link
Contributor Author

Source jar confirmed to align with build files.

image

Javadocs are no longer empty
image

@andrueastman andrueastman marked this pull request as ready for review February 27, 2025 15:00
@andrueastman andrueastman requested a review from a team as a code owner February 27, 2025 15:00
@andrueastman andrueastman merged commit 2d4c8fd into main Feb 27, 2025
11 checks passed
@andrueastman andrueastman deleted the andrueastman/fixjavaDocs branch February 27, 2025 15:02
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.

JavaDoc jar shipped with the SDK is empty JavaDoc has to be modified manually to map to its corresponding classes

3 participants