Help:Lint errors/ja

From mediawiki.org
This page is a translated version of the page Help:Lint errors and the translation is 33% complete.

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 個人設定 ; see 利用者の署名要件の改訂 .

Documentation of lint issues

優先度が高い lint エラー

優先度が中程度の lint エラー

優先度が低い lint エラー

Hidden lint categories

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

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

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

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 ...