Skip to content
This repository was archived by the owner on Jun 30, 2025. It is now read-only.

Commit 9616da1

Browse files
committed
docs: improved readme
1 parent 5d18643 commit 9616da1

File tree

2 files changed

+21
-3
lines changed

2 files changed

+21
-3
lines changed

README.md

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,27 @@
33

44
# Natspec Smells
55

6-
Just like code, documentation can smell, too. `natspec-smells` aims to help automatically identify missing or incomplete natspec.
6+
Just like code, documentation can smell too.
7+
Natspec Smells aims to help automatically identify missing or incomplete natspec.
78

8-
## Usage
9+
What can it do?
10+
11+
- Verifies natspec for: constructors, variables, functions, ~~structs~~, errors, events, modifiers
12+
- Finds misspelled or missing @param or @return's.
13+
- Lets you enforce the need for @inheritdoc in public/external functions.
14+
- Can integrate on your daily workflow, or just as a final check.
15+
16+
## No setup usage
17+
18+
Want to quickly check if your natspec smells?
19+
20+
Just run:
21+
22+
```
23+
npx @defi-wonderland/natspec-smells --include src --exclude test --exclude scripts
24+
```
25+
26+
## Recommended setup
927

1028
1. Install the package:
1129

src/main.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ import { Validator } from './validator';
1616

1717
const validator = new Validator(config);
1818
const processor = new Processor(validator);
19-
const warnings = processor.processSources(sourceUnits);
19+
const warnings = await processor.processSources(sourceUnits);
2020

2121
warnings.forEach(({ location, messages }) => {
2222
console.warn(location);

0 commit comments

Comments
 (0)