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

Medium-priority lint issues edit

Low-priority lint issues edit

Hidden lint categories edit

Hidden lint categories 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 category 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 category.

Impact on wikignome workflows edit

With the inclusion of hidden categories 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 categories do not show up in the Special:LintErrors page.
  • The REST API endpoint for fetching lint errors on a page will suppress lint issues from hidden categories
    • T360064 will provide ways to request lint issues from hidden categories
  • ... 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 categories in the where clause. Right now, this is going to be cumbersome and will require the enumeration of ids of hidden lint categories. But, we'll investigate providing easier options here.

... to be completed with a concrete example ..

List of hidden lint categories edit

Here is the current known list of hidden lint categories along with the lint category ids in the database for use in SQL queries with quarry.

... to be completed ...