Skip to content

Fix broken link check: ignore howtoforge cron guide URL (7.0) - #862

Merged
adiati98 merged 2 commits into
mautic:7.0from
Promptless:promptless/fix-broken-links-7.0
Jul 26, 2026
Merged

Fix broken link check: ignore howtoforge cron guide URL (7.0)#862
adiati98 merged 2 commits into
mautic:7.0from
Promptless:promptless/fix-broken-links-7.0

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Running the project's make checklinks (Sphinx linkcheck) on the 7.0 branch surfaced one broken link: the Apache Foundation cron-jobs guide at howtoforge.com, referenced from configuration/cron_jobs.rst, returns a 403 Forbidden to the automated checker. The page is live and correct in a browser — the 403 is an anti-bot block on the checker, not a dead link.

Per the Mautic community handbook's "Working with external links" guidance, a working URL that returns a non-404 error (403, timeout, anchor) should be added to linkcheck_ignore in docs/conf.py with an explanatory comment rather than replaced. This adds that single ignore entry, matching the existing convention in the list. The :xref: link itself is unchanged. After the change, make checklinks reports zero broken links on this branch.

@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

Just a reminder: I review PR comments by default. If you want me to ignore a specific comment, start it with aside or /aside.

@adiati98
adiati98 merged commit 39d5b4f into mautic:7.0 Jul 26, 2026
3 checks passed
@promptless-for-oss
promptless-for-oss deleted the promptless/fix-broken-links-7.0 branch July 26, 2026 18:43
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.

2 participants