-
Notifications
You must be signed in to change notification settings - Fork 2.7k
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
build: have vale lint only run on affected files #30378
base: main
Are you sure you want to change the base?
Conversation
Thanks for your pull request! The title of your pull request does not follow our editorial rules. Could you have a look?
|
296532e
to
cba55ea
Compare
actually, looks like vale automatically only scans files that matches an extension it knows about adoc, markdown, etc. thus not sure we even need to filter the incoming list? |
my only concern is why propertie files are set to be identified as markdown files? that could generate warning noise. Any reason why vale would want to look at properties? (there are none in our docs sources atm) |
This comment has been minimized.
This comment has been minimized.
@@ -22,13 +22,17 @@ jobs: | |||
steps: | |||
- name: Checkout | |||
uses: actions/checkout@v3 | |||
- id: files | |||
uses: jitterbit/get-changed-files@v1 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't have any alternative to offer right now, but jitterbit/get-changed-files#55 and the lack of recent activity in that repo might be issues worth considering.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
On my sandbox, I tested the exact Vale configuration that is suggested in this PR and added yaml gradle dev ..bad stuff to catch vale!
to line 58 in one file doc-contribute-docs-howto.adoc
.
The jitterbit et al config updates in this PR work perfectly afaics! The Vale Job in the same PR containing 1 edited adoc file now only takes 2 seconds instead of 1minute and 5 seconds!! Super job 👍 Thank you for your help to tweak this.
I also submitted PR #30397 to target main
with some tweaks to rules and the vale.ini as per the discussion above. Most of the config is optional and was specific to another project that checked .rst, properties, markdown and other doc source formats.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd suggest using a fork of that action which doesn't use the deprecated set-output
command: jitterbit/get-changed-files#55 (comment)
(at least until the original action shows signs of improvement)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@famod & @maxandersen - FYI - The Vale GitHub action issue was just updated to report that a fix "should be out next week." The same contributor is also working on a performance fix relating to Vale unnecessarily running all files when the config is set to report only problems with the diff. 🤞 # 82.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@michelle-purcell got a link to that issue? if the vale github action is being updated we might just wait for that...
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@maxandersen - Here are the 2 issues:
89 - Action fails even if fail_on_error is false
and
82 - reviewdog Vale is slower compared to its ancestor
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
okey so the fix they plan on next week is to just having the fail on error issue.
so i would say we merge what we have to getthe doc check to be much faster.
Resource bundles with localized strings maybe? |
Sure; but since we don't have those...could we remove that line and be done with it? |
Hey @maxandersen
As we only want to check AsciiDoc files in one specific directory, I think we could also look at removing other optional config lines in https://github.com/quarkusio/quarkus/blob/main/docs/.vale/vale.ini. I'll do some tests on my sandbox with the minimum config + Quarks rules and will submit a PR with those tweaks. Thanks |
@@ -49,6 +49,8 @@ As you make changes, you can rebuild the `docs` module specifically to update th | |||
./mvnw -f docs clean install | |||
---- | |||
|
|||
yaml gradle dev ..bad stuff to catch vale! | |||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The 2 spelling warnings above for 'gradle' and 'yaml' are not correct. The spelling is OK but the CASE is not. I fixed these in PR #30397. With this fix you only get one Vale warning for 'gradle' and 'yaml' .
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I just added those for test of the worflow. I'll get the pr updated to not include this before merging.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@maxandersen - Understood but the Vale rule results that were flagged on those terms didn't look good and needed some rule tweaks.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Great improvement to the Vale linter job. Thank you ⭐
cba55ea
to
1bc4ff1
Compare
This comment has been minimized.
This comment has been minimized.
Failing Jobs - Building 670bf99
Full information is available in the Build summary check run. Failures⚙️ JVM Tests - JDK 11 #- Failing: extensions/jdbc/jdbc-oracle/deployment
! Skipped: extensions/reactive-oracle-client/deployment integration-tests/jpa-oracle integration-tests/opentelemetry-jdbc-instrumentation and 1 more 📦 extensions/jdbc/jdbc-oracle/deployment✖
⚙️ JVM Tests - JDK 17 #- Failing: extensions/jdbc/jdbc-oracle/deployment
! Skipped: extensions/reactive-oracle-client/deployment integration-tests/jpa-oracle integration-tests/opentelemetry-jdbc-instrumentation and 1 more 📦 extensions/jdbc/jdbc-oracle/deployment✖
⚙️ JVM Tests - JDK 19 #📦 extensions/jdbc/jdbc-oracle/deployment✖
|
attempt on have vale lint only run on added/modified files.
for now just a draft as it passes all changed files to vale not just .adoc files.