Skip to content

Commit 26031eb

Browse files
authored
Disable document_ignores (#81)
1 parent 3e2ea36 commit 26031eb

File tree

3 files changed

+17
-3
lines changed

3 files changed

+17
-3
lines changed

CHANGELOG.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Changelog
22

3+
## 2.6.2
4+
5+
- Disable [`document_ignores`](https://dart.dev/tools/linter-rules/document_ignores.html) due to unnecessary verbosity
6+
37
## 2.6.1
48

59
Requires Dart `sdk: '>=3.5.0'`

lib/strict.yaml

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -427,12 +427,22 @@ linter:
427427
# https://dart.dev/tools/linter-rules/do_not_use_environment
428428
# - do_not_use_environment
429429

430-
# Ensures that ignore comments are properly documented with a reason
430+
# The reason for the ignore is usually self-evident and an additional comment would add unnecessary verbosity.
431+
# Also, when temporarily ignoring rules for debugging or development purposes, having to add documentation creates unnecessary overhead
432+
#
433+
# Example where it is annoying:
434+
#
435+
# ```dart
436+
# } catch (e, stack) {
437+
# // ignore: avoid_print
438+
# print(stack);
439+
# }
440+
# ```
431441
#
432442
# Dart SDK: >= 3.5.0
433443
#
434444
# https://dart.dev/tools/linter-rules/document_ignores
435-
- document_ignores
445+
# - document_ignores
436446

437447
# Add a comment why no further error handling is required
438448
#

pubspec.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name: lint
2-
version: 2.6.1
2+
version: 2.6.2
33
description: An opinionated, community-driven set of lint rules for Dart and Flutter projects. Like pedantic but stricter
44
repository: https://github.com/passsy/dart-lint
55
issue_tracker: https://github.com/passsy/dart-lint/issues

0 commit comments

Comments
 (0)