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

[SHRINKRES-340] fix typos, grammar, errors and add missing descriptions in javadoc #202

Merged

Conversation

xjusko
Copy link
Contributor

@xjusko xjusko commented May 13, 2024

@@ -56,7 +56,7 @@ class Invokable {
*
* @param cl classloader to be used
* @param classTypeName fully qualified class name
* @return
* @return the loaded {@code Class} object
Copy link
Member

Choose a reason for hiding this comment

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

Why the extra space?

* @param version
* @param packaging
* @param classifier
* @param groupId The group ID of the Maven coordinate.
Copy link
Member

Choose a reason for hiding this comment

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

Why the extra space here?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It looks correct to me, so the descriptions are lined up for better readability in IDE

* @param artifactId The artifact ID of the Maven coordinate.
* @param version The version of the Maven coordinate.
* @param packaging The packaging type of the Maven coordinate. Defaults to {@link PackagingType#JAR} if not specified.
* @param classifier The classifier of the Maven coordinate. If not specified, it defaults to the classifier derived from the packaging type.
Copy link
Member

Choose a reason for hiding this comment

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

Here the extra space is missing

@xjusko xjusko force-pushed the reviews-and-fix-javadoc-error-and-typos branch from 918ff80 to d692533 Compare May 13, 2024 13:28
@xjusko
Copy link
Contributor Author

xjusko commented May 13, 2024

Thanks @petrberan , I missed those when I was reviewing my changes, thanks, it should be fixed now.

@@ -243,7 +243,7 @@ public void pomRemoteBasedDependencies() {

/**
* Tests resolving a version from pom.xml which has non-default scope
* https://issues.jboss.org/browse/SHRINKRES-103
* <a href="https://issues.jboss.org/browse/SHRINKRES-103">SHRINKRES-103</a>
Copy link
Member

Choose a reason for hiding this comment

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

@@ -19,7 +19,7 @@
import org.jboss.shrinkwrap.resolver.api.maven.ScopeType;

/**
* Applies the default behavior exhibited by Maven with regards to handling transitive dependencies during resolution.
* Applies the default behavior exhibited by Maven in regard to handling transitive dependencies during resolution.
Copy link
Member

Choose a reason for hiding this comment

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

What about "Applies the default behavior exhibited by Maven in handling transitive dependencies during resolution."

@petrberan
Copy link
Member

I'm not a fan of those extra offset params in the javadoc. It may look good, but it's harder to maintain. Left some comments, otherwise looks good!

@petrberan
Copy link
Member

Also please don't forget to link this PR to the JIRA issue @xjusko !

@xjusko xjusko force-pushed the reviews-and-fix-javadoc-error-and-typos branch 3 times, most recently from 9e3df82 to 92c6170 Compare May 14, 2024 12:10
@xjusko
Copy link
Contributor Author

xjusko commented May 14, 2024

@petrberan, The errors should be fixed, I also included changing all SHRINKRES jira links in Javadoc to HTML links. Regarding the indentation in Javadoc, I removed all the unnecessary whitespace as you suggested.

@xjusko xjusko force-pushed the reviews-and-fix-javadoc-error-and-typos branch from 92c6170 to b41eed3 Compare May 15, 2024 08:50
@xjusko xjusko force-pushed the reviews-and-fix-javadoc-error-and-typos branch from b41eed3 to 1a53395 Compare May 15, 2024 11:44
@petrberan
Copy link
Member

Great job @xjusko , thank you

@petrberan petrberan merged commit 55aad77 into shrinkwrap:master May 16, 2024
2 checks passed
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.

2 participants