docs: migrate SDK page to tracebloc 0.8.x

[saadqbal]

Summary

• Rename tools-help/tracebloc-package.mdx → tools-help/tracebloc.mdx. Rewrite content for the canonical tracebloc name, snake_case API (post-SDK.2), and >=0.8.0 install pin.
• docs.json:
  • Nav entry → new slug.
  • Add /tools-help/tracebloc-package → /tools-help/tracebloc redirect so old inbound links don't 404.
  • Existing legacy redirects with destination /tools-help/tracebloc-package updated to the new slug.
• Internal cross-links in faqs.mdx and key-terms.mdx → new slug.
• join-use-case/start-training.mdx install snippet → new name + pin.

Companion to:

• tracebloc-py-package#135 — the rename.
• tracebloc/start-training#12 — notebooks coordinated change.

Closes #38.

Test plan

• Mintlify preview builds without warnings.
• /tools-help/tracebloc renders the new page.
• /tools-help/tracebloc-package 308-redirects to /tools-help/tracebloc (old inbound link preserved).
• Nav sidebar shows "tracebloc Python SDK" in the Tools & Help section.

🤖 Generated with Claude Code

---

Note

Low Risk
Low risk docs-only change that updates slugs, redirects, and code snippets; main risk is broken navigation/links if redirects or references are missed.

Overview
Updates the Python SDK documentation to the renamed tracebloc package (from tracebloc_package), including new install instructions pinned to >=0.8.1 and updated snake_case API examples.

Renames the Tools & Help page to tools-help/tracebloc, updates navigation and internal cross-links, and adds/adjusts redirects so legacy tracebloc-package URLs continue to resolve. Also refreshes Join-a-Use-Case docs snippets to use training_plan and the updated user.upload_model / link_model_dataset call patterns.

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

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
tracebloc	🟢 Ready	View Preview	May 13, 2026, 10:09 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit d5da9e1. Configure here.}

[saadqbal]

Adding one more commit (fc4b9c2) — expands the PR to also fix the camelCase API surface in the three customer-facing pages that still showed it.

This is the same 0.7.0 / SDK.2 migration that landed in tracebloc-py-package/MIGRATION.md but never made it into Mintlify. Same scope shape as the rest of this PR (docs catch-up to where the SDK already is), so folding it in here rather than as a separate ticket.

What changed (just the SDK example pages)

• join-use-case/start-training.mdx
• join-use-case/hyperparameters.mdx
• join-use-case/model-optimization.mdx

Method renames

Old (still works, emits DeprecationWarning)	New
uploadModel(path)	upload_model(model_name=path)
linkModelDataset(id)	link_model_dataset(dataset_id=id)
getTrainingPlan()	get_training_plan()
experimentName(...)	experiment_name(...)
learningRate(...)	learning_rate(...)
lossFunction(...)	loss_function(...)
layersFreeze(...)	layers_freeze(...)
earlystopCallback(...)	early_stop_callback(...)
reducelrCallback(...)	reduce_lr_callback(...)
modelCheckpointCallback(...)	model_checkpoint_callback(...)
terminateOnNaNCallback()	terminate_on_nan_callback()
trainingClasses(...)	training_classes(...)
dataType(...)	data_type(...)

Also: local variable trainingObject → training_plan to match the canonical sample workflow in tracebloc/tracebloc-py-package's CLAUDE.md.

Kwargs note

model_name and dataset_id aren't aliased in 0.8.x — passing modelname= or datasetId= raises TypeError. Docs now use the explicit kwarg form to steer users to the safe spelling.

[saadqbal]

Bugbot pass on eefc578:

#	Issue	Severity	Status
1	sync-sources.yml still points dest: tools-help/tracebloc-package.mdx after the file rename (bugbot)	High	Fixed — repointed to tools-help/tracebloc.mdx

Why this matters

.github/workflows/sync-docs.yml runs daily on a cron + on repository_dispatch from source repos. It reads sync-sources.yml and writes upstream content into each dest. With the old path:

• The daily cron would have either recreated an orphan tools-help/tracebloc-package.mdx (not in the nav after this PR's docs.json change), or
• failed outright, silently preventing further README → docs page syncs.

What I didn't change

The mapping id: tracebloc-package stays the same — that's a dispatch slug, not a content path. The comment in sync-sources.yml notes it's used in the source repo's notify workflow; renaming it would require a coordinated change there. Grep on tracebloc/tracebloc-py-package finds no such workflow today, but leaving the id stable keeps the option open without breaking anything.

Audit

$ grep -rn "tracebloc-package\.mdx\|tracebloc_package\.mdx" \
    --include="*.yml" --include="*.yaml" --include="*.md" \
    --include="*.mdx" --include="*.json" .
# (no output — no remaining orphan path references)