Skip to content

docs: add markdownlint workflow configuration and fix markdown issues#1975

Open
igoropaniuk wants to merge 4 commits intoqualcomm-linux:masterfrom
igoropaniuk:docs/linter_and_improvements
Open

docs: add markdownlint workflow configuration and fix markdown issues#1975
igoropaniuk wants to merge 4 commits intoqualcomm-linux:masterfrom
igoropaniuk:docs/linter_and_improvements

Conversation

@igoropaniuk
Copy link
Copy Markdown
Contributor

  • Add markdownlint configuration and GitHub Actions CI workflow to enforce
    consistent markdown style on push/PR
  • Fix lint violations: add language specifiers to fenced code blocks,
    use consistent list style, and wrap bare URLs
  • Fix typos and grammar in README.md (e.g. "comminication", "to able")
  • Correct VID:PID order, pluralize "branches", and generalize the
    stable branch contribution note

Comment thread .github/.markdownlint.yaml
@igoropaniuk igoropaniuk force-pushed the docs/linter_and_improvements branch from 58ad235 to 9ff77ea Compare April 16, 2026 14:09
@igoropaniuk igoropaniuk force-pushed the docs/linter_and_improvements branch from 9ff77ea to 721a6af Compare April 16, 2026 16:33
Comment thread .github/workflows/pr.yml Outdated
@igoropaniuk igoropaniuk changed the title docs: add markdownlint workflow configuration and fix markdown issues [RFC] docs: add markdownlint workflow configuration and fix markdown issues Apr 16, 2026
@igoropaniuk igoropaniuk force-pushed the docs/linter_and_improvements branch 3 times, most recently from 0535b2c to 59eeec4 Compare April 16, 2026 16:49
@igoropaniuk
Copy link
Copy Markdown
Contributor Author

igoropaniuk commented Apr 16, 2026

@lumag do you have GitHub Action configured to run workflows that already exist on the base branch (master)? I don't have any other explanations why the workflow introduced in this PR is not triggered

@github-actions
Copy link
Copy Markdown

Test run workflow

Test jobs for commit 59eeec4

Test dragonboard-820c qcs615-adp-air qcs6490 qcs8300 qcs9100 qcs9100-rb8 qrb2210-rb1
AudioRecord 🚫 pass pass pass pass 🚫 pass
BT_FW_KMD_Service 🚫 pass pass pass pass pass fail
BT_ON_OFF 🚫 pass pass pass pass pass pass
BT_SCAN 🚫 pass pass pass pass pass pass
CPUFreq_Validation 🚫 pass pass pass pass pass pass
DSP_AudioPD 🚫 pass pass pass pass pass pass
Ethernet 🚫 ⚠️ skip 🚫 ⚠️ skip pass pass ⚠️ skip
Interrupts 🚫 pass pass pass pass pass pass
KMSCube 🚫 ⚠️ skip pass ⚠️ skip ⚠️ skip pass pass
OpenCV 🚫 pass pass pass pass pass pass
WiFi_Firmware_Driver 🚫 pass pass pass pass pass pass
WiFi_OnOff 🚫 pass pass pass pass pass pass
adsp_remoteproc 🚫 pass pass pass pass pass pass
boot pass pass pass pass pass pass pass
cdsp_remoteproc 🚫 pass pass pass pass pass ⚠️ skip
core_auth 🚫 pass pass pass pass pass pass
fastrpc_test 🚫 pass pass pass pass pass 🚫
hotplug 🚫 pass pass pass pass pass pass
irq 🚫 pass pass pass pass pass pass
weston-simple-egl 🚫 ⚠️ skip pass ⚠️ skip ⚠️ skip pass pass

All jobs summary

Job ID Device State Health
179983 qcs615-adp-air Finished Complete
179998 qcs9100-rb8 Finished Complete
180000 qcs8300 Finished Complete
179991 qcs9100-rb8 Finished Complete
179958 qcs6490 Finished Complete
179999 qcs615-adp-air Finished Complete
179995 qrb2210-rb1 Finished Complete
179979 qcs615-adp-air Finished Incomplete
179959 dragonboard-820c Finished Complete
179937 qcs615-adp-air Finished Complete
179981 qcs615-adp-air Finished Complete
179960 qrb2210-rb1 Finished Complete
179994 qcs9100 Finished Incomplete
179987 qcs8300 Finished Complete
179992 qcs9100 Finished Complete
179989 qcs6490 Finished Complete
179947 qcs9100-rb8 Finished Complete
179977 qrb2210-rb1 Finished Complete
179954 qcs8300 Finished Complete
180001 qcs9100 Finished Complete
179961 qcs615-adp-air Finished Complete
179957 qcs6490 Finished Complete
180011 qcs9100 Finished Complete
180008 qcs6490 Finished Complete
180009 qcs9100-rb8 Finished Complete
180007 qrb2210-rb1 Finished Complete
179942 qcs615-adp-air Finished Complete
179955 qrb2210-rb1 Finished Complete
179951 qcs615-adp-air Finished Complete
179990 qcs6490 Finished Complete
180012 qcs9100-rb8 Finished Complete
179938 qrb2210-rb1 Finished Complete
180010 qrb2210-rb1 Finished Complete
179936 qcs6490 Finished Complete
179939 qcs9100-rb8 Finished Complete
179982 qcs8300 Finished Complete
180006 qcs8300 Finished Complete
180003 qcs6490 Finished Complete
180002 qcs615-adp-air Finished Complete
179948 qcs9100 Finished Complete
179988 qcs9100 Finished Complete
179940 qcs8300 Finished Complete
180005 qcs8300 Finished Complete
179949 qcs9100 Finished Complete
179941 qcs8300 Finished Complete
179985 qrb2210-rb1 Finished Complete
179993 qcs9100 Finished Complete
179945 qcs9100-rb8 Finished Complete
179978 qcs8300 Finished Complete
179943 qcs9100 Finished Complete
179950 dragonboard-820c Finished Complete
179997 qrb2210-rb1 Finished Complete
179980 qcs9100-rb8 Finished Complete
179944 dragonboard-820c Finished Complete
179935 qcs6490 Finished Complete
179946 qcs9100 Finished Complete
179952 qcs9100-rb8 Finished Complete
179984 qcs615-adp-air Finished Complete
179986 qcs9100-rb8 Finished Complete
179996 qcs6490 Finished Complete
180004 qcs6490 Finished Complete
179956 qcs8300 Finished Complete
179962 qrb2210-rb1 Finished Complete
179953 dragonboard-820c Finished Complete

@test-reporting-app
Copy link
Copy Markdown

test-reporting-app Bot commented Apr 16, 2026

Test Results

 28 files  ±0   28 suites  ±0   1h 3m 41s ⏱️ + 4m 39s
 13 tests ±0    9 ✅ +1  0 💤 ±0  4 ❌  - 1 
221 runs   - 1  217 ✅ ±0  0 💤 ±0  4 ❌  - 1 

For more details on these failures, see this check.

Results for commit 554dc01. ± Comparison against base commit b21d78a.

This pull request removes 1 and adds 1 tests. Note that renamed tests count towards both.
lava ‑ fastboot-boot
lava ‑ minimal-boot

♻️ This comment has been updated with latest results.

Comment thread .github/workflows/markdownlint.yml Outdated
Comment thread .github/workflows/pr.yml Outdated
Comment thread .github/workflows/pr.yml Outdated
Comment thread README.md Outdated
@anujm1
Copy link
Copy Markdown
Contributor

anujm1 commented Apr 17, 2026

@lumag do you have GitHub Action configured to run workflows that already exist on the base branch (master)? I don't have any other explanations why the workflow introduced in this PR is not triggered

Not sure if you already got the answer to this. It didn't run because it needs to be added to allowed list first.

Add a markdownlint configuration (.github/.markdownlint.yaml) and a
GitHub Actions workflow to enforce consistent markdown style across
the project.

The workflow runs as a standalone check on pushes to master and on
all pull requests when markdown files or the linter configuration
change.

Update paths-ignore in the PR build workflow to skip builds for
markdown-only changes, since those are already covered by the
standalone markdownlint workflow.

Disabled rules:
- MD013 (line length): existing docs exceed the default limit
- MD033 (inline HTML): used throughout the documentation

Signed-off-by: Igor Opaniuk <igor.opaniuk@oss.qualcomm.com>
Add language specifiers to all fenced code blocks (MD040),
use consistent dash style for unordered lists (MD004), and
wrap bare URL in angle brackets (MD034).

Signed-off-by: Igor Opaniuk <igor.opaniuk@oss.qualcomm.com>
Fix extra space before period, correct "so to able" to "to be able",
and fix "comminication" typo.

Signed-off-by: Igor Opaniuk <igor.opaniuk@oss.qualcomm.com>
Correct VID:PID order to match USB convention, use plural "branches"
in the Branches section, and generalize the kirkstone-specific
contribution note to cover all stable branches.

Signed-off-by: Igor Opaniuk <igor.opaniuk@oss.qualcomm.com>
@igoropaniuk igoropaniuk force-pushed the docs/linter_and_improvements branch from 59eeec4 to 554dc01 Compare April 20, 2026 11:38
@igoropaniuk
Copy link
Copy Markdown
Contributor Author

Pushed updated version

@github-actions
Copy link
Copy Markdown

Test run workflow

Test jobs for commit 554dc01

Test dragonboard-820c qcs615-adp-air qcs6490 qcs8300 qcs9100 qcs9100-rb8 qrb2210-rb1
boot pass pass pass pass pass pass pass

All jobs summary

Job ID Device State Health
183715 qrb2210-rb1 Finished Complete
183728 qcs9100-rb8 Finished Complete
183720 qcs9100-rb8 Finished Complete
183730 qcs9100 Finished Complete
183717 qcs8300 Finished Complete
183727 qcs615-adp-air Finished Complete
183736 qcs6490 Finished Complete
183716 qcs8300 Finished Complete
183724 qcs9100 Finished Complete
183738 qrb2210-rb1 Finished Complete
183721 dragonboard-820c Finished Complete
183722 qrb2210-rb1 Finished Complete
183740 qcs9100-rb8 Finished Complete
183713 qcs615-adp-air Finished Incomplete
183735 qcs8300 Finished Complete
183734 dragonboard-820c Finished Complete
183719 qcs615-adp-air Finished Complete
183731 qcs615-adp-air Finished Complete
183729 dragonboard-820c Finished Complete
183732 qcs6490 Finished Complete
183714 qrb2210-rb1 Finished Complete
183726 qcs6490 Finished Complete
183739 qcs9100 Finished Complete
183733 qcs9100-rb8 Finished Complete
183725 qcs6490 Finished Complete
183723 qcs9100 Finished Complete
183718 qcs8300 Finished Complete
183737 dragonboard-820c Finished Complete

@igoropaniuk igoropaniuk changed the title [RFC] docs: add markdownlint workflow configuration and fix markdown issues docs: add markdownlint workflow configuration and fix markdown issues Apr 22, 2026
@anujm1
Copy link
Copy Markdown
Contributor

anujm1 commented Apr 23, 2026

I still see:

The action DavidAnson/markdownlint-cli2-action@05f3221 is not allowed in qualcomm-linux/meta-qcom

so perhaps @mynameistechno can you please review and help?

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.

5 participants