Skip to content

[to #348] add javadoc in maven site reporting#507

Merged
zz-jason merged 4 commits intotikv:masterfrom
iosmanthus:mvn-site-patch
Feb 11, 2022
Merged

[to #348] add javadoc in maven site reporting#507
zz-jason merged 4 commits intotikv:masterfrom
iosmanthus:mvn-site-patch

Conversation

@iosmanthus
Copy link
Copy Markdown
Member

@iosmanthus iosmanthus commented Feb 10, 2022

Signed-off-by: iosmanthus myosmanthustree@gmail.com

What problem does this PR solve?

Issue Number: close #348

What is changed and how does it work?

This pull request move javadoc generating into maven site reporting section
image

Signed-off-by: iosmanthus <myosmanthustree@gmail.com>
Comment on lines -448 to -467
<!-- Javadoc Plug-in -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.0.1</version>
<configuration>
<skip>${javadoc.skip}</skip>
</configuration>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
<configuration> <!-- add this to disable checking -->
<additionalparam>-Xdoclint:none</additionalparam>
</configuration>
</execution>
</executions>
</plugin>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

After deleting this, does mvn javadoc:javadoc still works? Users may want to solely generate apidocs themselves.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Doesn't work again, needs to run mvn compile site instead.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

could you add a github action to automatically compile the site for each release?

</execution>
</executions>
</plugin>
<!--- Needs to shade Protobuf 3 since other projects might use other version -->
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Accidentally deleted?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yes, recovered.

pom.xml Outdated
Comment on lines +263 to +265
<configuration>
<skip>${javadoc.skip}</skip>
</configuration>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Currently javadoc.skip defaults to true. Why do we want to skip the javadoc generation in mvn site and set this as default behavior?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Removed this configuration.

Signed-off-by: iosmanthus <myosmanthustree@gmail.com>
Signed-off-by: iosmanthus <myosmanthustree@gmail.com>
@peng1999
Copy link
Copy Markdown
Member

LGTM

@ti-srebot
Copy link
Copy Markdown
Collaborator

@peng1999, Thanks for your review. The bot only counts LGTMs from Reviewers and higher roles, but you're still welcome to leave your comments. You are not a reviewer or committer or co-leader or leader.

Copy link
Copy Markdown
Member

@zz-jason zz-jason left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Copy Markdown
Collaborator

@marsishandsome marsishandsome left a comment

Choose a reason for hiding this comment

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

LGTM

@zz-jason
Copy link
Copy Markdown
Member

/merge

@ti-srebot
Copy link
Copy Markdown
Collaborator

/run-all-tests

@zz-jason zz-jason merged commit 48c309e into tikv:master Feb 11, 2022
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.

full document support

5 participants