Skip to content

ci: add linting workflow for docs (markdown + spelling)#100

Open
nikhilsk wants to merge 2 commits intoROCm:mainfrom
nikhilsk:chore/add-linting-workflow
Open

ci: add linting workflow for docs (markdown + spelling)#100
nikhilsk wants to merge 2 commits intoROCm:mainfrom
nikhilsk:chore/add-linting-workflow

Conversation

@nikhilsk
Copy link
Copy Markdown
Contributor

Motivation

Technical Details

Test Plan

Test Result

Submission Checklist

@nikhilsk nikhilsk force-pushed the chore/add-linting-workflow branch 3 times, most recently from 1e6f0da to c8f4f85 Compare February 18, 2026 10:24
@nikhilsk nikhilsk marked this pull request as ready for review February 18, 2026 10:25
@nikhilsk nikhilsk requested a review from sgopinath1 February 18, 2026 10:27
@nikhilsk nikhilsk force-pushed the chore/add-linting-workflow branch from c8f4f85 to 1c52018 Compare March 5, 2026 10:02
Copy link
Copy Markdown
Collaborator

@sgopinath1 sgopinath1 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@@ -0,0 +1,37 @@
name: Linting
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why are we not using rocm's standard doc linting workflow here?

AMD_CTK_PATH=$(CURDIR)/bin/$(BIN_DIRECTORY_SUFFIX)/amd-ctk go test -v ./...

# Docs lint (Markdown + spelling; matches CI linting checks)
DOCS_MARKDOWNLINTCONFIG ?= .markdownlint.yaml
Copy link
Copy Markdown
Member

@shiv-tyagi shiv-tyagi Mar 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check what ROCm/rocm-docs-core/.github/workflows/linting.yml uses and add similar targets here (for local runs) while using the same job in CI?

That would help us in reducing extra maintenance of these targets.

docs-lint-docker-build: ## Build the docs-lint image locally (for Dockerfile changes or first-time setup).
docker build -t $(DOCS_LINT_IMAGE) -f $(CURDIR)/tools/docs-lint/Dockerfile $(CURDIR)/tools/docs-lint

docs-lint-docker-push: docs-lint-docker-build ## Build and push the docs-lint image to the registry (for maintainers/CI).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This kind of maintenance I am taking about. We should use something where we don't have to worry about all this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants