Ruleset design
No complex presetsβ
Sheriff doesn't offer βrecommendedβ or βstrictβ presets. This config contains a predefined set of rules meant to act as guidelines for a functional-light programming style.
No esoteric Typescript-only featuresβ
Sheriff tries to be as faithful to Javascript as possible and conceives Typescript as a tool to enhance the capabilities that Javascript already has. Because of this, Sheriff discourages typescript-only features, like enums and overloads (and classes, and decorators by extensions, even though they also landed in Ecmascript).
Minimal formatting opinionsβ
Unlike other ESLint configurations, Sheriff tries to be as unopinionated as possible about formatting, to be aligned with the community philosophy on the matter (1, 2).
Sheriff encourage you to bring your own formatting tool.
The only formatting rules that Sheriff currently enforces are @stylistic/padding-line-between-statements
and curly
.
Opinionated but flexibleβ
If you just donβt like some rules you can disable them on a case-by-case basis.
If you want to adopt a more OOP programming style, or if you feel like the config is too strict, you can disable everything that bothers you.
But if you decide to adopt this config, you should trust it and let it do itβs thing.
If you end up fighting it all the way, maybe reconsider about whether or not adopting it.
There are some pretty big hot-takes in this config. Learn more in the Stylistic choices explanations section. Also in the FAQs there are even more hot-takes, if you are into that πΆοΈ.