1.8 KiB
1.8 KiB
Working on syntaxes
Please help us enhance and debug the syntaxes we use in stylelint:
To contribute to a syntax, you should:
- Familiarize yourself with PostCSS’s how to write custom syntax guide.
- Use the
syntax: *
labels to identify which syntax is behind an issue. - Go to the repository for that syntax.
- Read their contributing guidelines.
Workarounds
Fixing bugs in syntaxes can take time. stylelint can work around these bug by turning off autofix for incompatible sources. Autofix can then remain safe to use while contributors try to fix the underlying issue.
Current workarounds
stylelint currently turns off autofix for sources that contain:
nested tagged template literals (issue #4119)
Add a workaround
To add a new workaround, you should:
- Add code to
lib/lintSource.js
to detect the incompatible pattern. - Add a corresponding test to
lib/__tests__/standalone-fix.test.js
. - Document the workaround in
docs/developer-guides/syntaxes.md
.