mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
31 lines
666 B
Markdown
31 lines
666 B
Markdown
|
# DocLint
|
||
|
|
|
||
|
|
**Doclint** is a small program that lints Puppeteer's documentation against
|
||
|
|
Puppeteer's source code.
|
||
|
|
|
||
|
|
Doclint works in a few steps:
|
||
|
|
|
||
|
|
1. Read sources in `lib/` folder, parse AST trees and extract public API
|
||
|
|
2. Read sources in `docs/` folder, render markdown to HTML, use puppeteer to traverse the HTML
|
||
|
|
and extract described API
|
||
|
|
3. Compare one API to another
|
||
|
|
|
||
|
|
Doclint is also responsible for general markdown checks, most notably for the table of contents
|
||
|
|
relevancy.
|
||
|
|
|
||
|
|
## Running
|
||
|
|
|
||
|
|
```bash
|
||
|
|
npm run doc
|
||
|
|
```
|
||
|
|
|
||
|
|
## Tests
|
||
|
|
|
||
|
|
Doclint has its own set of jasmine tests, located at `utils/doclint/test` folder.
|
||
|
|
|
||
|
|
To execute tests, run:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
npm run test-doclint
|
||
|
|
```
|