File: linting.md

package info (click to toggle)
rocm-docs-core 1.23.0-5
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 2,632 kB
  • sloc: python: 1,960; sh: 160; javascript: 152; cpp: 29; makefile: 27
file content (24 lines) | stat: -rw-r--r-- 1,013 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
---
myst:
    html_meta:
        "description": "Linting ensures correct Markdown and ReStructuredText formatting on every pull request"
        "keywords": "Formatting PR, Formatting pull requests, Linting checks, Documentation settings"
---

# Linting

`rocm-docs-core` has linting to ensure correct Markdown and ReStructuredText
formatting on every pull request (PR) via GitHub Actions.

If a PR fails linting, the errors must be addressed before it can be merged.

The results of linting is viewable in the "Checks" tab for a PR.

## Markdown Linting

The current linter used for Markdown is [`markdownlint`](https://github.com/DavidAnson/markdownlint),
which uses the [following rules](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md).

### Optional

`markdownlint` can also be installed and run locally using the [`markdownlint` extension](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) on [Visual Studio Code](https://code.visualstudio.com/Download).