docs: lead with declarative ingest.yaml + curl-installer helm upgrade note

[divyasinghds]

Summary

Mirrors the corresponding data-ingestors PR. Driven by user feedback after a fresh end-to-end setup.

• prepare-dataset.mdx — adds a new "Declarative YAML (recommended)" section before the existing Quick Setup / Detailed Setup walkthroughs. The simpler flow (helm install tracebloc/ingestor --set-file ingestConfig=./ingest.yaml) is now the default; the existing Python-template + Docker + Kubernetes Job flow stays as the advanced path under a short framing intro. Calls out that ingest.yaml fields vary per category and links to examples/yaml/ and templates/.
• setup-guide.mdx — adds a Note after the curl one-liner with the right helm-upgrade command for installer-deployed clients: helm upgrade <workspace> tracebloc/client -n <namespace> --reset-then-reuse-values (with the --version pinning tip), linking to the existing Configuration → Upgrade section.

Test plan

• Preview both pages in the docs site (Mintlify) and confirm callouts/links render correctly
• Follow the declarative flow end-to-end against a fresh client and confirm the page sequence (setup-guide → prepare-data) reads top-to-bottom without dead ends
• Confirm the advanced (Python template) section still works as a fallback for users on that path

🤖 Generated with Claude Code

---

Note

Low Risk
Low risk documentation-only changes; main risk is user confusion if Helm commands/links are incorrect.

Overview
Adds a new declarative ingest.yaml ingestion path to prepare-dataset.mdx as the recommended default, including Helm repo setup, PVC data staging guidance, a per-category ingest.yaml example, and the helm install tracebloc/ingestor --set-file ingestConfig=... command, while reframing the existing Python-template/Kubernetes Job workflow as advanced.

Updates setup-guide.mdx with a note for one-liner installs documenting the correct helm upgrade ... --reset-then-reuse-values command (and optional --version pinning) with a link to the upgrade docs.

^{Reviewed by Cursor Bugbot for commit 049395b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[LukasWodka]

👋 Heads-up — Code review queue is at 19 / 8

Above the WIP limit. The team convention is to review existing PRs before opening new work.

Open PRs currently in Code review (oldest first):

• cli#1 — Phase 1: embed ingest.v1.json + tracebloc ingest validate · author: @saadqbal · no reviewer assigned
• client-runtime#36 — Bump requests from 2.32.3 to 2.33.0 in /Node-deploy · author: @dependabot · no reviewer assigned
• client-runtime#37 — Bump black from 25.1.0 to 26.3.1 in /Node-deploy · author: @dependabot · no reviewer assigned
• client-runtime#38 — Bump requests from 2.32.3 to 2.33.0 · author: @dependabot · no reviewer assigned
• client-runtime#39 — Bump black from 25.1.0 to 26.3.1 · author: @dependabot · no reviewer assigned
• data-ingestors#108 — Copy tokenizer.json to training pod for MLM datasets · author: @shujaatTracebloc · reviewer: @saadqbal
• data-ingestors#114 — docs: flag per-category ingest.yaml + curl-installer helm upgrade tip · author: @divyasinghds · no reviewer assigned
• design-system#19 — fix: un-track coverage/ and node_modules/ from git · author: @LukasWodka · no reviewer assigned
• docs#3 — Block bots from crawling Mintlify static assets · author: @LukasWodka · reviewer: @saadqbal
• model-zoo#74 — Add 9 MLM model variants and remove warmstart · author: @shujaatTracebloc · reviewer: @divyasinghds

Pull from review before opening new work. (This is a nudge from the kanban WIP check, not a block.)