Skip to content

Re-enable the documentation checks - #8024

Open
dimitrieh wants to merge 3 commits into
mainfrom
re-enable-docs-checks
Open

Re-enable the documentation checks#8024
dimitrieh wants to merge 3 commits into
mainfrom
re-enable-docs-checks

Conversation

@dimitrieh

@dimitrieh dimitrieh commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Deletes the two if: false lines, so the doc link checks run again and broken links get caught before publishing.

Merge after FlowFuse/website#5473. test-with-website needs that PR in order to build a docs PR against its own docs. Before it, this fails on Missing script: "docs".

Should also restore the needs on publish that #8029 drops.

test is blocked by something unrelated and repo-wide: npm ci rejects the lockfile with lock file's globals@17.8.0 does not satisfy globals@17.9.0. Build and contenerize fails the same way.

Also fixes five broken (optional) anchors in docs/. An unescaped ( ends a markdown link target, so they point at nothing. They are also what makes this PR's own checks run, since the workflow only triggers on docs/**.

Restores docs.yml to its state before the checks were disabled. With both
jobs skipped, publish was skipped too, so merging a docs change no longer
triggered a website rebuild and docs only went live on the website's daily
cron.

test-with-website needs FlowFuse/website#5473 to merge first: it relies on
the website build picking up the sibling flowfuse checkout, which is what
that PR restores.
@dimitrieh
dimitrieh requested a review from hardillb August 3, 2026 09:40
@dimitrieh
dimitrieh marked this pull request as ready for review August 3, 2026 09:40
@dimitrieh

Copy link
Copy Markdown
Contributor Author

comment with context at FlowFuse/website#5432 (comment)

@hardillb

hardillb commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

@dimitrieh we can't just re-enable them, those steps need fixing first to use the new website process.

@dimitrieh

dimitrieh commented Aug 3, 2026

Copy link
Copy Markdown
Contributor Author

True, this needs to be merged in order after FlowFuse/website#5473 as defined in the comment and in the body of this pr

An unescaped ( ends a markdown link target, so #enable-https-(optional) and
#setting-up-mosquitto-(optional) point at nothing and leave a stray ) in the
text. The rendered ids are enable-https-optional and setting-up-mosquitto-optional.
@dimitrieh dimitrieh changed the title Re-enable documentation checks Re-enable the documentation checks Aug 3, 2026
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