Help:Lint errors
When Parsoid parses a page's wikitext, it identifies patterns in wikitext that are probably mistakes. This page documents the potential issues.
The lint errors are currently displayed by the Linter extension, see Help:Extension:Linter. In the future they may also be shown when editing your signature in Preferences; see New requirements for user signatures.
Documentation of lint issues
[edit]High-priority lint issues
[edit]- deletable-table-tag
- pwrap-bug-workaround
- self-closed-tag
- tidy-whitespace-bug
- html5-misnesting
- tidy-font-bug
- multiple-unclosed-formatting-tags
- multiline-html-table-in-list
- unclosed-quotes-in-heading
- misc-tidy-replacement-issues
- duplicate-ids
Medium-priority lint issues
[edit]Low-priority lint issues
[edit]- missing-end-tag
- missing-end-tag-in-heading
- stripped-tag
- obsolete-tag
- night-mode-unaware-background-color
Hidden lint issues
[edit]Hidden lint issues have priority set to none in the linter extension. Conceptually, these are a different class of issues than the previous categories and cover the following areas.
- They might be early explorations and experiments at defining a problematic wikitext usage -- the hidden nature lets developers / product teams fine tune the linting logic and the scope of the lint and also allow for engage in a discussion without needing immediate action and fixups. Eventually, these might either be undeployed OR promoted to a non-hidden lint issue for fixup by editors and bots.
- They might be a result of content analyses that might be used in other ways other than surfacing it in the Linter UI. In this case, the Linting product is being used for its analysis and storage capabilities and is not meant to feed direct action by editors and hence will never be promoted to a non-hidden lint issue.
Impact on wikignome workflows
[edit]With the inclusion of hidden issues as a concept, the goal is to minimize (and if possible, fully eliminate) any impact on existing workflows of wikignomes. Right now, this is what has been enabled.
- Hidden lint issues do not show up in the Special:LintErrors page.
- The REST API endpoint for fetching lint errors on a page will suppress hidden lint issues
- T360064 will provide ways to request hidden lint issues
- ... to be completed with any other things ...
... to be completed with any other impacts not yet addressed ...
Suppressing hidden lints from quarry results
[edit]Additionally, editors who query the linter database replicas directly via quarry are recommended to update their queries to exclude the hidden issues in the where clause. Right now, this is going to be cumbersome and will require the enumeration of ids of hidden lint issues. But, we'll investigate providing easier options here, see T334527.
For an example of how to exclude specific linter issues from a query, see the join page on page.page_id line in the query at en:Wikipedia:Linter/reports/Articles by Lint Errors.
List of hidden lint issues
[edit]Here is the current known list of hidden lint issues along with the lint issue ids in the database for use in SQL queries with quarry.