Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add api docs to docs dir #1301

Merged
merged 2 commits into from
Dec 12, 2020
Merged

add api docs to docs dir #1301

merged 2 commits into from
Dec 12, 2020

Conversation

cgardens
Copy link
Contributor

@cgardens cgardens commented Dec 11, 2020

We build API docs but they just get dumped in a build dir. Trying to at least dump them in docs/ so that we can refer contributors to them. Tried this before and was having issues with ensuring a clean repository, hoping will be okay this time.

@@ -98,6 +98,18 @@ task generateApiDocs(type: GenerateTask) {
generatePom : "false",
interfaceOnly: "true"
]

doLast {
Copy link
Contributor

Choose a reason for hiding this comment

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

would it make sense to output the docs there by default instead of doing a copy?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

mostly trying to keep the pattern the same where we generate to the build dir, and then separately copy it where it needs to go. i think building to something outside of module is not great. i'm also not sure the gen allows it, but i can double check.

@cgardens cgardens marked this pull request as ready for review December 12, 2020 00:41
@cgardens cgardens merged commit 8e4cbbe into master Dec 12, 2020
@cgardens cgardens deleted the cgardens/api_docs7 branch December 12, 2020 02:30
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.

3 participants