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

Fix path of /docs/ [ci skip] #6075

Open
wants to merge 5 commits into
base: dev-2.x
Choose a base branch
from

Conversation

JustCris654
Copy link

Summary

Fix the wrong mentions of the documentation folder which changed from /docs to /doc/user and in the function comments from /docs to /doc

@JustCris654 JustCris654 requested a review from a team as a code owner September 18, 2024 13:34
Copy link

codecov bot commented Sep 18, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 69.79%. Comparing base (b108104) to head (f09d3be).

Additional details and impacted files
@@            Coverage Diff             @@
##             dev-2.x    #6075   +/-   ##
==========================================
  Coverage      69.78%   69.79%           
- Complexity     17357    17358    +1     
==========================================
  Files           1962     1962           
  Lines          74357    74357           
  Branches        7623     7623           
==========================================
+ Hits           51893    51895    +2     
+ Misses         19820    19819    -1     
+ Partials        2644     2643    -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@JustCris654
Copy link
Author

I added a commit to fix one last mention that I forgot before

@leonardehrenfried leonardehrenfried changed the title Fix path of /docs/ Fix path of /docs/ [ci skip] Sep 19, 2024
@@ -14,7 +14,7 @@ public interface DocsTestConstants {
File USER_DOC_PATH = new File(DOC_ROOT, "user");

/**
* This method return {@code true} if the /docs directory is available. If not, a warning is
* This method return {@code true} if the /doc directory is available. If not, a warning is

Choose a reason for hiding this comment

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

This should probably say /doc/user right? At least that is the path that the code is looking at.

@@ -24,7 +24,7 @@ static boolean docsExistOrWarn() {
}
LOG.warn(
"""
SKIP TEST - '/docs' NOT FOUND
SKIP TEST - '/doc' NOT FOUND

Choose a reason for hiding this comment

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

/doc/user here as well

Copy link
Author

Choose a reason for hiding this comment

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

Yeah you're right. But what about the warn string just below in the LOG.warn?

The doc/templates directory might not be available if you run the tests outside the root of the projects. This may happen if the project root is not the working directory, if you run tests using jar files or in a Maven multi-module project.

Shouldn't we check also if the doc/template directory exist? And change the comment accordingly quoting both doc/user and doc/templates.

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