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

[Backport] [2.x] New javadoc and improvement of existing javadoc (#10064) #10563

Merged
merged 1 commit into from
Oct 11, 2023

Conversation

reta
Copy link
Collaborator

@reta reta commented Oct 11, 2023

Backport of #10064 to 2.x

@github-actions
Copy link
Contributor

github-actions bot commented Oct 11, 2023

Compatibility status:

Checks if related components are compatible with change 4158a52

Incompatible components

Skipped components

Compatible components

Compatible components: [https://github.com/opensearch-project/security.git, https://github.com/opensearch-project/alerting.git, https://github.com/opensearch-project/index-management.git, https://github.com/opensearch-project/anomaly-detection.git, https://github.com/opensearch-project/asynchronous-search.git, https://github.com/opensearch-project/sql.git, https://github.com/opensearch-project/observability.git, https://github.com/opensearch-project/common-utils.git, https://github.com/opensearch-project/job-scheduler.git, https://github.com/opensearch-project/reporting.git, https://github.com/opensearch-project/security-analytics.git, https://github.com/opensearch-project/k-nn.git, https://github.com/opensearch-project/cross-cluster-replication.git, https://github.com/opensearch-project/custom-codecs.git, https://github.com/opensearch-project/geospatial.git, https://github.com/opensearch-project/ml-commons.git, https://github.com/opensearch-project/notifications.git, https://github.com/opensearch-project/performance-analyzer.git, https://github.com/opensearch-project/performance-analyzer-rca.git, https://github.com/opensearch-project/neural-search.git]

…0064)

* Fixing javadoc error
fixing javadoc error and warning
javadoc for org.opensearch.core.indices.breaker
javadoc for org.opensearch.core.index.shard.ShardId
javadoc for org.opensearch.core.index.Index
fixing a mishap in formatting rule
fixing javadoc of org.opensearch.cli.Terminal

Signed-off-by: Laurent Laborde <[email protected]>

* removing unsupported @ImplNote

Signed-off-by: Laurent Laborde <[email protected]>

* Update libs/common/src/main/java/org/opensearch/common/collect/Iterators.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update libs/compress/src/main/java/org/opensearch/compress/ZstdCompressor.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Apply suggestions from code review

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Apply suggestions from code review

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Apply suggestions from code review

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Apply suggestions from code review

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update CollectionUtils.java

Signed-off-by: Laurent Laborde <[email protected]>

* fixing javadoc warnings

Signed-off-by: Laurent Laborde <[email protected]>

* remove useless p tag

Signed-off-by: Laurent Laborde <[email protected]>

* removing a p tag

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* proper capitalization

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* improvements of existing javadocs

Signed-off-by: Laurent Laborde <[email protected]>

* javadoc improvement

Signed-off-by: Laurent Laborde <[email protected]>

* javadoc improvement

Signed-off-by: Laurent Laborde <[email protected]>

* Fix formatting error after merge conflict resolution in a javadoc

Signed-off-by: Laurent Laborde <[email protected]>

* "code" tag ignore carriage return & "p", switching to a "pre" tag

Signed-off-by: Laurent Laborde <[email protected]>

* fixing an overzealous precommit check error.

Signed-off-by: Laurent Laborde <[email protected]>

* Update distribution/tools/launchers/src/main/java/org/opensearch/tools/launchers/SystemJvmOptions.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update server/src/internalClusterTest/java/org/opensearch/search/sort/GeoDistanceSortBuilderIT.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update server/src/main/java/org/opensearch/action/admin/cluster/repositories/get/GetRepositoriesRequest.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update server/src/main/java/org/opensearch/action/admin/cluster/snapshots/create/CreateSnapshotRequest.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update server/src/main/java/org/opensearch/action/admin/indices/replication/SegmentReplicationStatsRequest.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update server/src/main/java/org/opensearch/cluster/RestoreInProgress.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update test/framework/src/main/java/org/opensearch/test/AbstractDiffableWireSerializationTestCase.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* Update test/framework/src/main/java/org/opensearch/test/AbstractDiffableSerializationTestCase.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* further improvement of javadoc after review & suggestions

Signed-off-by: Laurent Laborde <[email protected]>

* fixing unreferenced @link in javadoc (precommit error)

Signed-off-by: Laurent Laborde <[email protected]>

* removing p tag from internal comment

Signed-off-by: Laurent Laborde <[email protected]>

* reverting javadoc tag in licence header

Signed-off-by: Laurent Laborde <[email protected]>

* Update server/src/main/java/org/opensearch/search/aggregations/metrics/AbstractPercentilesAggregationBuilder.java

Co-authored-by: Andriy Redko <[email protected]>
Signed-off-by: Laurent Laborde <[email protected]>

* conflict resolution

Signed-off-by: Laurent Laborde <[email protected]>

---------

Signed-off-by: Laurent Laborde <[email protected]>
Co-authored-by: Andriy Redko <[email protected]>
(cherry picked from commit c0852f8)
Signed-off-by: Andriy Redko <[email protected]>
@reta reta force-pushed the backport/backport-10064-to-2.x branch from 655312d to 4158a52 Compare October 11, 2023 14:33
@github-actions
Copy link
Contributor

Gradle Check (Jenkins) Run Completed with:

@github-actions
Copy link
Contributor

Gradle Check (Jenkins) Run Completed with:

@github-actions
Copy link
Contributor

Gradle Check (Jenkins) Run Completed with:

@github-actions
Copy link
Contributor

Gradle Check (Jenkins) Run Completed with:

  • RESULT: UNSTABLE ❕
  • TEST FAILURES:
      1 org.opensearch.search.SearchWeightedRoutingIT.testStrictWeightedRoutingWithCustomString_FailOpenEnabled

@codecov
Copy link

codecov bot commented Oct 11, 2023

Codecov Report

Merging #10563 (4158a52) into 2.x (422cf06) will increase coverage by 0.06%.
Report is 1 commits behind head on 2.x.
The diff coverage is n/a.

@@             Coverage Diff              @@
##                2.x   #10563      +/-   ##
============================================
+ Coverage     70.83%   70.89%   +0.06%     
- Complexity    58509    58521      +12     
============================================
  Files          4830     4830              
  Lines        276386   276386              
  Branches      40580    40580              
============================================
+ Hits         195788   195956     +168     
+ Misses        63877    63692     -185     
- Partials      16721    16738      +17     
Files Coverage Δ
...c/main/java/org/opensearch/gradle/BwcVersions.java 88.34% <ø> (ø)
...ava/org/opensearch/gradle/LoggingOutputStream.java 0.00% <ø> (ø)
...search/gradle/precommit/TestingConventionRule.java 0.00% <ø> (ø)
...ensearch/gradle/tar/SymbolicLinkPreservingTar.java 0.00% <ø> (ø)
...ensearch/gradle/test/rest/RestResourcesPlugin.java 0.00% <ø> (ø)
.../org/opensearch/gradle/vagrant/VagrantMachine.java 0.00% <ø> (ø)
...rg/opensearch/gradle/vagrant/VagrantShellTask.java 0.00% <ø> (ø)
...earch/client/benchmark/metrics/SampleRecorder.java 0.00% <ø> (ø)
...main/java/org/opensearch/client/ClusterClient.java 8.57% <ø> (ø)
.../java/org/opensearch/client/RequestConverters.java 84.21% <ø> (ø)
... and 224 more

... and 453 files with indirect coverage changes

@reta
Copy link
Collaborator Author

reta commented Oct 11, 2023

@dblock @kotwanikunal mind please approving folks, large backport :)

@reta reta merged commit 966b78d into opensearch-project:2.x Oct 11, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants