Skip to content
This repository has been archived by the owner on Mar 25, 2021. It is now read-only.

Docs: add note to docs about zero-indexing for machine formatters #4544

Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions docs/formatters/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,12 @@ order: 2

Lint _formatters_ allow for transformation of lint results into various forms before outputting to stdout or a file.

Formatters are split into two categories: _human-readable_ and _machine-readable_. Please note that for machine-readable
formatters formatters all positioning is zero-indexed (lines start with zero), whereas human-readable formatters are not (lines start with one).

### Built-in formatters

{% assign formatters = site.data.formatters | sort: "name" %}
{% for formatter in formatters %}
* [{{formatter.formatterName}}]({{formatter.formatterName}}) - {{formatter.description | markdownify | remove:"<p>" | remove: "</p>"}}
{% endfor %}
* [{{formatter.formatterName}}]({{formatter.formatterName}}) - {{formatter.description | markdownify | remove:"<p>" | remove: "</p>"}} ({{formatter.consumer}}-readable)
{% endfor %}