Skip to content

[Javadoc] Add missing package-info.java files to server#3128

Merged
nknize merged 1 commit intoopensearch-project:mainfrom
nknize:missingJavaDoc/pkginfo/server
May 2, 2022
Merged

[Javadoc] Add missing package-info.java files to server#3128
nknize merged 1 commit intoopensearch-project:mainfrom
nknize:missingJavaDoc/pkginfo/server

Conversation

@nknize
Copy link
Copy Markdown
Contributor

@nknize nknize commented May 2, 2022

In preparation for re-enabling the missingJavadoc gradle task this change adds
in the missing package-info.java files to the server folder. For now general
javadocs are added to these files with the intent to clean up with better
descriptions over time.

This change also adds support for @OpenSearch.internal and
@OpenSearch.experimental javadoc tags for marking classes and
methods that should not be extended by "external" plugins.

relates #221
relates #2868

In preparation for re-enabling the missingJavadoc gradle task this change adds
in the missing package-info.java files to the server folder. For now general
javadocs are added to these files with the intent to clean up with better
descriptions over time.

Signed-off-by: Nicholas Walter Knize <nknize@apache.org>
@nknize nknize added documentation Improvements or additions to documentation enhancement Enhancement or improvement to existing feature or request Build Libraries & Interfaces non-issue bugs / unexpected behaviors that end up non issues; audit trail simple changes that aren't issues v2.1.0 Issues and PRs related to version 2.1.0 v3.0.0 Issues and PRs related to version 3.0.0 labels May 2, 2022
@nknize nknize requested review from a team and reta as code owners May 2, 2022 18:16
@nknize nknize requested a review from setiah May 2, 2022 18:16
@nknize nknize mentioned this pull request May 2, 2022
86 tasks
@opensearch-ci-bot
Copy link
Copy Markdown
Collaborator

✅   Gradle Check success 421453e
Log 4905

Reports 4905

project(":qa:os"),
project(":qa:wildfly"),
project(":rest-api-spec"),
project(":server"),
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This change is not very unclear: we do exactly what the same thing by extracting configure(project(":server")) into separate configuration block.

Copy link
Copy Markdown
Contributor Author

@nknize nknize May 2, 2022

Choose a reason for hiding this comment

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

It's starting to isolate the projects that will have missingJavadoc reenabled. To test this locally comment out isExcluded = true and uncomment the following two lines.

    // TODO: reenable after fixing missing javadocs
    // javadocMissingLevel = "class"

This is done intentional for incremental progress toward re-enabling. Otherwise I'm going to have to (un)copypasta this for each incremental PR

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Ah I see, thanks @nknize !

@nknize nknize merged commit 2146827 into opensearch-project:main May 2, 2022
@nknize nknize added the backport 2.x Backport to 2.x branch label May 2, 2022
opensearch-trigger-bot bot pushed a commit that referenced this pull request May 2, 2022
In preparation for re-enabling the missingJavadoc gradle task this change adds
in the missing package-info.java files to the server folder. For now general
javadocs are added to these files with the intent to clean up with better
descriptions over time.

Signed-off-by: Nicholas Walter Knize <nknize@apache.org>
(cherry picked from commit 2146827)
dblock pushed a commit that referenced this pull request May 3, 2022
In preparation for re-enabling the missingJavadoc gradle task this change adds
in the missing package-info.java files to the server folder. For now general
javadocs are added to these files with the intent to clean up with better
descriptions over time.

Signed-off-by: Nicholas Walter Knize <nknize@apache.org>
(cherry picked from commit 2146827)

Co-authored-by: Nick Knize <nknize@apache.org>
@nknize nknize added the backport 2.0 Backport to 2.0 branch label May 13, 2022
nknize added a commit that referenced this pull request May 13, 2022
In preparation for re-enabling the missingJavadoc gradle task this change adds
in the missing package-info.java files to the server folder. For now general
javadocs are added to these files with the intent to clean up with better
descriptions over time.

Signed-off-by: Nicholas Walter Knize <nknize@apache.org>
(cherry picked from commit 2146827)
nknize pushed a commit that referenced this pull request May 13, 2022
In preparation for re-enabling the missingJavadoc gradle task this change adds
in the missing package-info.java files to the server folder. For now general
javadocs are added to these files with the intent to clean up with better
descriptions over time.

Signed-off-by: Nicholas Walter Knize <nknize@apache.org>
(cherry picked from commit 2146827)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport 2.x Backport to 2.x branch backport 2.0 Backport to 2.0 branch Build Libraries & Interfaces documentation Improvements or additions to documentation enhancement Enhancement or improvement to existing feature or request non-issue bugs / unexpected behaviors that end up non issues; audit trail simple changes that aren't issues v2.1.0 Issues and PRs related to version 2.1.0 v3.0.0 Issues and PRs related to version 3.0.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants