Closed roslynwythe closed 8 months ago
Hi @elliot-d-kim, thank you for taking up this issue! Hfla appreciates you :)
Do let fellow developers know about your:- i. Availability: (When are you available to work on the issue/answer questions other programmers might have about your issue?) ii. ETA: (When do you expect this issue to be completed?)
You're awesome!
P.S. - You may not take up another issue until this issue gets merged (or closed). Thanks again :)
Availability: Mon-Thu outside of 2-7pm, Fri before 2pm, Sat all day ETA: 2/13/24
Progress Update
@elliot-d-kim Please detail the files involved and whether they have liquid statements or just YAML front matter that is causing the problem with CodeQL. Thanks!
It seems that the current CodeQL configuration can't scan JS files when YAML, Liquid, etc. is mixed in. The error message "Could not process some files due to syntax errors" sounds to me like these are not simply false alarms of code smells but rather indications that these "syntax errors" prevent CodeQL from scanning the 6 files involved.
I believe the YAML and Liquid in these .js files are responsible. No other files in the .js directory have non-JS code, and CodeQL has no problem scanning those.
Summary: Non-JS code in these files
hamburger-nav.js
: YAML front-matter with a titletoolkit.js
: 1 line of Liquid, empty YAML front-matterwins.js
: 2 lines (Liquid), empty YAML front-matterproject.js
: 2 lines (Liquid), empty YAML front-matterabout.js
: for loop (Liquid), empty YAML front-mattercurrent-project.js
: 2 lines + for loop (Liquid), empty YAML front-matterTesting results
I did the latter in total 4 .js files: note that the message goes from "5 other warnings like this" (refer to the very first screenshot) to "1 other" in the following screenshot:
Deleting the Liquid lines would break the site (and CodeQL raised those errors accordingly in testing), so an alternative, holistic solution is required.
Deleting the YAML front-matter in hamburger-nav.js
made the file free of non-JS code and made the file completely free of CodeQL errors.
Errors in smaller views: Hamburger nav is not used in larger views but it appears in smaller or mobile views. This is mentioned in comments in _sass/components/_header-nav.scss
under /* Hamburger nav CSS */
(line 83). Thus, while it causes no issues in larger views, deleting hamburger-nav.js
's non-empty YAML front-matter causes a rendering error in smaller views.
Great job @elliot-d-kim - your analysis is clear and compelling and supported by your testing. In future issues we will explore various options for solutions. Let me know if you would like to be involved in that work.
Great, I'd definitely be interested in exploring solutions. I'm also curious about the progression of an issue like this up to solution implementation, so please keep me in the loop!
If you are interested in working on the epic please contact me via Slack
Overview
The CodeQL workflow GHA is reporting that it cannot scan 6 files in the gh-pages branch of hackforla/website due to extraction errors, presumably due to syntax errors. We need to resolve those errors to ensure complete testing coverage.
Action Items
Resources/Instructions
GitHub CodeQL documentation. workflow run logs for codeql.yml