Skip to content

docs: fix 2 broken links flagged by Mintlify link-rot check - #7

Merged
saadqbal merged 2 commits into
developfrom
fix/linkrot-2-broken-links
Apr 28, 2026
Merged

docs: fix 2 broken links flagged by Mintlify link-rot check#7
saadqbal merged 2 commits into
developfrom
fix/linkrot-2-broken-links

Conversation

@LukasWodka

Copy link
Copy Markdown
Contributor

Surgical fix for the two broken links Mintlify has been flagging on every PR. Both pre-existing on main.

What changes

FileChange
environment-setup/setup-guide.mdxRemove dead self-reference: [Quick Setup](/getting-started/quick-setup) — that page no longer exists, and the closest redirect (/getting-started/quickstart) loops back to this same page. The installer one-liner already serves as the "short version".
join-use-case/overview.mdxRemove image reference to images/tracebloc-workflow-overview.png — the file does not exist in the repo. Surrounding text already explains the workflow. A proper diagram can be added later as a separate PR.

Why now

Mintlify Validation - link-rot fails on every PR until these are fixed (currently blocking docs#3). Net diff: -2 lines.

Test plan

  • After merge: re-run Mintlify link-rot on any open docs PR — should pass
  • Visit /environment-setup/setup-guide and /join-use-case/overview — both render correctly without dead reference / missing image

🤖 Generated with Claude Code

@saadqbal
saadqbal merged commit 27ae646 into developApr 28, 2026
3 checks passed
saadqbal added a commit that referenced this pull request May 6, 2026
)
* chore: add auto-add to engineer kanban workflow (#5)
* Add auto-add to engineer kanban workflow
* fix(ci): pin actions/add-to-project to v1.0.2
@v1 is not a valid tag — action publishes full semver only. Pin to v1.0.2.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* Merge pull request #6 from tracebloc/chore/process-bootstrap
chore: add PR template + customer bump + stale auto-close
* docs: fix 2 broken links flagged by Mintlify link-rot check (#7)
* docs: remove dead /getting-started/quick-setup self-reference
* docs: remove missing tracebloc-workflow-overview.png reference
* chore: add .gitignore (macOS, editor, Mintlify cache) (#8)
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* chore: add default CODEOWNERS for auto-reviewer assignment (#9)
* ci: add kanban closure-routing caller workflow (#10)
* chore: revert default CODEOWNERS — switching back to author-picks-reviewer (#12)
* ci: add WIP-limit-check caller workflow (#11)
* docs: sync content from legacy Docusaurus repo
Port recent updates from the legacy tracebloc/documentation repo into
the Mintlify docs site:
- create-use-case/prepare-dataset: <workspace> placeholder, host-PVC
ingestion (replaces COPY-into-image), Docker Hub setup, ingestor-job
cleanup, multi-arch buildx (linux/amd64,linux/arm64)
- create-use-case/prerequisites: add Tabular Regression, Time Series
Forecasting, Time to Event Prediction; fix label CSV columns and
example links; add filename-omits-extension Note
- environment-setup/configuration, eks-client-deployment-guide,
setup-guide: align with unified tracebloc/client Helm chart 1.3.x;
installer URL → i.sh / i.ps1; corrected PVC keys; PSA labels and
node-agents namespace
join-use-case updates (hyperparameters, start-training) split into a
separate PR.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* docs: document Pod Security restricted-profile fix for ingestor job
Clusters that enforce the restricted Pod Security Standard reject
the ingestor pod with a PodSecurity admission warning. Document the
two-part fix:
- Add a securityContext block (allowPrivilegeEscalation=false,
runAsNonRoot=true, capabilities drop ALL, seccompProfile
RuntimeDefault) to the container in ingestor-job.yaml.
- Add a non-root USER (UID 1000) to the Dockerfile before the
entrypoint so runAsNonRoot is satisfied.
Includes a "Run as non-root" troubleshooting subsection with the
verbatim warning text users will see, and updates the inline
Dockerfile and ingestor-job.yaml snippets to match.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* docs: update overview installer URLs to short i.sh / i.ps1
Align overview/tracebloc.mdx with the rest of the docs, which
already reference https://tracebloc.io/i.sh and i.ps1.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* docs: drop redundant H1 that duplicates the frontmatter title
Mintlify renders the frontmatter title as the page H1, so an
explicit "# Title" line below the frontmatter renders as a
duplicate heading. Remove these on 7 pages.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: lukasWuttke <54042461+LukasWodka@users.noreply.github.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Divya <divyasingh@tracebloc.io>
@divyasinghds
divyasinghds deleted the fix/linkrot-2-broken-links branch May 11, 2026 10:40
Sign up for freeto 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

@LukasWodka@saadqbal