diff --git a/.github/workflows/README.md b/.github/workflows/README.md
index d171bd87..37bac496 100644
--- a/.github/workflows/README.md
+++ b/.github/workflows/README.md
@@ -55,9 +55,10 @@ This directory contains the GitHub Actions workflows for the MangoWC project.
 - Workflow file itself: `.github/workflows/docs.yml`
 
 **What it does**:
-- Lints all markdown files using markdownlint-cli2
+- Lints markdown files in the repository using markdownlint-cli2
 - Checks for common markdown formatting issues
 - Ensures documentation follows consistent style guidelines
+- Excludes dependency directories (wayland, wlroots, scenefx) to only lint repository files
 
 ### lock.yml
 **Purpose**: Automatically locks inactive issues and PRs to keep the repository clean.
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index fbd8c914..45743f5d 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -27,5 +27,9 @@ jobs:
         uses: DavidAnson/markdownlint-cli2-action@v18
         with:
           globs: |
-            **/*.md
+            *.md
+            .github/**/*.md
             !**/node_modules/**
+            !**/wayland/**
+            !**/wlroots/**
+            !**/scenefx/**