Skip to content

Update YAML filename matching pattern reference link #598

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

Merged
merged 1 commit into from
Jun 17, 2025

Conversation

per1234
Copy link
Contributor

@per1234 per1234 commented Jun 17, 2025

Several significant files use the YAML language, but not the standard .yml or .yaml file extensions. In order to provide full coverage, "yamllint" and the paths filter of the "Check YAML" workflow must be configured with the patterns for these files.

A list of filename patterns for the YAML language is maintained in the "Linguist" project. Even though Linguist is not used by this infrastructure, the data from the Linguist source code serves as a reference from which the list of patterns was derived. In order to facilitate maintenance of the list of file patterns, comments were added to the yamllint configuration file and the "Check YAML" workflow providing a link to the reference.

In the Linguist project, the data for all programming languages is stored in a single data file, which makes that file less useful as a reference for a specific language, as is needed here.

The linguist-languages package is generated from the Linguist language data file, with a separate file for each language, so it serves as a more convenient reference. The linguist-languages package is automatically generated, and is used by Prettier, so it is likely to be actively maintained. For these reasons, previously that package was used in the reference link. However, during a recent review of the reference links it was found that it no longer worked. For this reason, it was replaced with a link to the less useful Linguist source code.

I have now performed an investigation into the situation with the linguist-languages package and found the new location of the content. So it is now possible to go back to using this superior reference. Several factors have resulted in the reference URL being different than before:

  • Repository transferred to a new owner
  • Default branch renamed
  • Data format changed from JSON to JavaScript

Several significant files use the YAML language, but not the standard `.yml` or `.yaml` file extensions. In order to
provide full coverage, "yamllint" and the paths filter of the "Check YAML" workflow must be configured with the patterns
for these files.

A list of filename patterns for the YAML language is maintained in the "Linguist" project. Even though Linguist is not
used by this infrastructure, the data from the Linguist source code serves as a reference from which the list of
patterns was derived. In order to facilitate maintenance of the list of file patterns, comments were added to the
yamllint configuration file and the "Check YAML" workflow providing a link to the reference.

In the Linguist project, the data for all programming languages is stored in a single data file, which makes that file
less useful as a reference for a specific language, as is needed here.

The linguist-languages package is generated from the Linguist language data file, with a separate file for each
language, so it serves as a more convenient reference. The linguist-languages package is automatically generated, and is
used by Prettier, so it is likely to be actively maintained. For these reasons, previously that package was used in the
reference link. However, during a recent review of the reference links it was found that it no longer worked. For this
reason, it was replaced with a link to the less useful Linguist source code.

I have now performed an investigation into the situation with the linguist-languages package and found the new location
of the content. So it is now possible to go back to using this superior reference. Several factors have resulted in the
reference URL being different than before:

* Repository transferred to a new owner
* Default branch renamed
* Data format changed from JSON to JavaScript
@per1234 per1234 self-assigned this Jun 17, 2025
@per1234 per1234 added type: enhancement Proposed improvement topic: code Related to content of the project itself labels Jun 17, 2025
@per1234 per1234 merged commit 364143b into arduino:main Jun 17, 2025
16 checks passed
@per1234 per1234 deleted the update-yaml-file-pattern-ref branch June 18, 2025 16:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
topic: code Related to content of the project itself type: enhancement Proposed improvement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant