docs: add docs-linkcheck to the commands to test
Metadata
Current evaluation
Test PR to validate CI path filtering for docs-only changes. Closed without merging after confirming the filter correctly skips lint-code and runs docs jobs.
Resolution: closed resolved
Reason: The PR was explicitly marked as a test and not intended to merge. It successfully validated the CI path filter configuration, achieving its purpose and was closed.
Evaluated by: mr-cal-bot
No scores available.
Issue body
## Purpose
Docs-only filter test, stacked on canonical/starbase#626. Not intended to merge.
This branch changes `docs/README.md` and nothing else.
## What it tests
Whether starflow's paths filter classifies this change as documentation only,
so the right jobs run:
| Job | Expected | Why |
|---|---|---|
| `filter` | runs | always |
| `files` (`make -k lint-code`) | **skipped** | `docs/**` and `**/*.md` are excluded from `source-files` |
| `docs` (`make -k docs-lint`) | runs | `docs-files` matches `docs/**` |
| `linkcheck` (`make -k docs-linkcheck`) | runs | `docs-files` matches `docs/**` |
This is the "yes-docs, no-code" case, which the pull requests so far have not
covered. `docs-lint` and `docs-linkcheck` must both pass, and `lint-code` must
not appear in the run list at all.
## Stacked on this
Source-plus-docs filter test: canonical/starbase#632
## Related
- canonical/starbase#625
- canonical/starbase#626
- canonical/starflow#199
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | closed resolved | Test PR to validate CI path filtering for docs-only changes. Closed without merging after confirming the filter correctly skips lint-code and runs docs jobs. |
Update history
| Date | Change |
|---|---|
| closed | |
| updated | |
| created |
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #630 docs: add docs-linkcheck to the commands to test | starbase | closed | Test PR verifying starflow's docs-only path filter; not intended to merge. Closed after testing purpose was served. | |
| #2972 ci: test docs and linkcheck jobs in starflow lint workflow | charmcraft | closed | Draft test PR to verify starflow lint workflow docs and linkcheck jobs. Closed without merging as it was only for integration testing. | |
| #625 ci(lint): improve CI UX when splitting linter jobs | starbase | closed | Splits linkcheck from docs-lint into a standalone docs-linkcheck Make target to enable separate CI lint jobs. All CI passing, awaiting first review. | |
| #632 test: touch a source file and a docs file together | starbase | closed | Test PR to validate CI path filtering for source+docs changes. Closed without merging as it was not intended to merge, stacked on #628. | |
| #551 docs: resolve `docs-lint` issues | starbase | merged | Merged as f44e2e7, excluding docs/_dev from Sphinx linting and configuring linkcheck to report timeouts separately from broken links. |