Skip to content

Commit

Permalink
[Doc] Add work flow of checking broken links (apache#5529)
Browse files Browse the repository at this point in the history
  • Loading branch information
Anonymitaet authored and sijie committed Nov 4, 2019
1 parent cbad217 commit 7f513e5
Showing 1 changed file with 20 additions and 1 deletion.
21 changes: 20 additions & 1 deletion site2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,25 @@ cd pulsar/site2/website
yarn test
```

### Check

Before submitting a pull request, run the following command to make sure no broken links exist.

```
cd pulsar/site2/website
yarn build
```

If warning messages are shown as below, it means broken links exist.

```
[WARN] unresolved links in file 'version-2.4.1/getting-started-standalone.md' > [ 'security-overview.md' ]
[WARN] unresolved links in file 'version-2.4.0/io-managing.md' > [ 'functions-overview.md' ]
```

Fix the broken links manually and then send a pull request.

## Documentation
Pulsar documents are written in English. Documentation related pages are placed in the `/site2/docs` directory. All documentation pages are versioned. For more details, refer to [versioning](#versioning).

Expand Down Expand Up @@ -256,4 +275,4 @@ The translated docs are downloaded to the `site2/website/translated_docs` direct
### Check issues, fix and verify

After download the translated documents, you can open the target markdown file, check issues and fix them.
To verify if you have fixed the issues correctly, [run the site locally](#run-the-site-locally).
To verify if you have fixed the issues correctly, [run the site locally](#run-the-site-locally).

0 comments on commit 7f513e5

Please sign in to comment.