Skip to content

Missing Latinism rule for "viz." (namely/specifically) in Canonical Style #200

@rajannpatel

Description

@rajannpatel

The Latin abbreviation viz. (short for videlicet) is currently missing from the list of latinisms defined under the 025a-latinisms-with-english-equivalents.yml rule.

According to style guidelines, Latin abbreviations should be replaced with plain English alternatives such as "namely" or "specifically".

Proposed Change

Add the following regex and translation to styles/Canonical/025a-latinisms-with-english-equivalents.yml:

  \b(?:viz\.(?!\w)|viz(?![\w\.])): "'specifically' or 'namely'"

Rationale & Regex Design

The proposed pattern prevents false-positive flags on domains, email addresses, and words containing viz:

  • viz\.(?!\w): Matches viz. (with a dot) unless it is immediately followed by a word character (e.g., matching "viz. " but ignoring "viz.com" or "viz.org").
  • viz(?![\w\.]): Matches viz (without a dot) unless followed by a word character or a dot (e.g., matching "viz, " or "viz " but ignoring "vizier", "vizard", or "supervise").

Reproducible Test Case

test-viz.md

<!-- Expected to trigger warnings -->
Please provide the details, viz. the names and dates.
We have three options, viz, red, green, and blue.
The results are clear viz the chart below.

<!-- Expected to pass silently (No False Positives) -->
The vizier advised the sultan.
Check the website at viz.com or viz.org.
We need to supervise the process.

Vale Linter Output:

$ vale test-viz.md

test-viz.md
 2:30  error  Instead of 'viz.', use 'specifically' or 'namely'.  Canonical.025a-latinisms-with-english-equivalents
 3:24  error  Instead of 'viz', use 'specifically' or 'namely'.   Canonical.025a-latinisms-with-english-equivalents
 4:24  error  Instead of 'viz', use 'specifically' or 'namely'.   Canonical.025a-latinisms-with-english-equivalents

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions