Skip to content

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

Merged
saadqbal merged 2 commits intodevelopfrom
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 intodevelopfrom
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

File Change
environment-setup/setup-guide.mdx Remove 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.mdx Remove 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 develop Apr 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>
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