Automattic / Automattic/harper

Flag "refer" used on its own when "refer to" is meant.

Open
#1,156 3 comments 0 reactions 0 assignees View on GitHub
enhancement harper-core linting
Dominant language
Rust
Stars
15.4k
Forks
627
Avg merge
1d 15h
Merged PRs (30d)
102

Description

## Description

This is the of thing non-native English speakers often write. I just read this:
```
Refer the base protocol for more details.
```
Refer on its own has a very different meaning: "The doctor referred me to a specialist".
Refer to a dictionary for full definitions.

## Examples

- [How to **refer** a file under patches which is exists in another ...](https://github.com/kubernetes-sigs/kustomize/discussions/5417)
- I am trying to **refer** a variable in serverless.yml from another yml file,but when I run serverless deploy it does nothing.
- [How to define and reuse/**refer** the definition in document. ...](https://github.com/RicoSuter/NSwag/issues/3589)

## Potential False Positives

Disambiguation may be tricky, but perhaps just `refer a` / `refer the` will work well.

Contributor guide

Open the contributing guide

Research direction

Start by finding the grammar rule implementation and its existing test coverage, then use the reported examples and potential false-positive cases as initial test inputs. Done means the checker flags uses such as “refer the...” or “refer a...” when “refer to” is intended without incorrectly flagging valid uses such as “referred me to a specialist”.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
tooling
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.