Skip to content

docs(frameworks): correct TensorFlow support claims (backend#2298) - #134

Closed
aptracebloc wants to merge 1 commit into
mainfrom
fix/2298-correct-tf-docs-claims
Closed

docs(frameworks): correct TensorFlow support claims (backend#2298)#134
aptracebloc wants to merge 1 commit into
mainfrom
fix/2298-correct-tf-docs-claims

Conversation

@aptracebloc

@aptracebloc aptracebloc commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

TensorFlow is retired. New TF model uploads are now rejected (backend#2427); existing/historical TF experiments remain readable (RFC-BACKEND-2232, D3). The public docs still advertised TensorFlow as a supported upload framework — this corrects that.

Targets main per the docs-repo exception.

What changed

  • Removed TensorFlow from the supported-upload / framework-choice lists: overview/tracebloc.mdx, join-use-case/overview.mdx, tools-help/faqs.mdx, and the per-task "Frameworks:" lines in join-use-case/how-training-works.mdx (image classification, tabular classification, tabular regression).
  • Dropped the pip install "tracebloc[tensorflow]" extra from both install snippets (tools-help/tracebloc.mdx, join-use-case/start-training.mdx) and noted the SDK FutureWarning + removal in 1.0.0.
  • Reframed the model-upload authoring guide (join-use-case/model-optimization.mdx) and the TF-specific reference material (hyperparameters.mdx, how-training-works.mdx) as deprecated / read-only for existing experiments, via page-level notes — the detail stays accurate for the historical experiments that remain readable (D3), rather than being deleted.

Verification

  • make check-sdk-extras reviewed: only the [tensorflow] extra was removed; all other documented extras are unchanged and valid. Full mint broken-links + SDK-extras run pending on a networked machine (both need network this sandbox lacks). No new links introduced.

Closes tracebloc/backend#2298

— drafted with Claude Code


Note

Low Risk
Documentation-only wording and install-snippet updates; no product, auth, or runtime behavior changes.

Overview
Stops advertising TensorFlow as a supported new-upload framework. New models should use PyTorch or scikit-learn; existing TensorFlow experiments remain readable.

Adds page-level deprecation notes on training, hyperparameters, model formats, overview, FAQs, and the SDK install guide. Drops the tracebloc[tensorflow] extra from install snippets and notes the SDK FutureWarning plus removal in 1.0.0.

TensorFlow-specific pipeline, hyperparameter, and file-format details are kept as historical reference rather than deleted. Per-task “Frameworks” lines (image/tabular classification and tabular regression) and product copy now list PyTorch/sklearn instead of TensorFlow.

Reviewed by Cursor Bugbot for commit aa13ec0. Bugbot is set up for automated code reviews on this repo. Configure here.

TensorFlow is retired: new TF model uploads are rejected (backend#2427),
while existing TF experiments remain readable (RFC-BACKEND-2232, D3). Remove
TensorFlow from the supported-upload framework lists, drop the [tensorflow]
install extra, and reframe the remaining TF-specific reference material as
deprecated/read-only for existing experiments.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@aptracebloc
aptracebloc requested a review from saadqbal August 24, 2026 08:58
@mintlify

mintlify Bot commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
tracebloc 🟢 Ready View Preview Aug 24, 2026, 9:02 AM

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

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Fix All in Cursor

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

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit aa13ec0. Configure here.

Comment thread tools-help/tracebloc.mdx

<Note>
TensorFlow is deprecated. New TensorFlow model uploads are no longer accepted — install `[pytorch]` (or `[sklearn]`) for new models. The SDK raises a `FutureWarning` for TensorFlow, and TensorFlow support is removed in 1.0.0. Existing TensorFlow experiments remain readable.
</Note>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Synced pages edited at destination

Medium Severity

These pages are sync destinations in sync-sources.yml (tracebloc-packagetools-help/tracebloc.mdx, start-trainingjoin-use-case/start-training.mdx) and must be edited at their upstream READMEs. The Installation snippet syncs from source, so the next upstream sync can restore tracebloc[tensorflow] and undo this correction.

Additional Locations (1)
Fix in Cursor Fix in Web

Triggered by project rule: Bugbot guide — tracebloc/docs

Reviewed by Cursor Bugbot for commit aa13ec0. Configure here.

@aptracebloc

Copy link
Copy Markdown
Contributor Author

Superseded by #135, retargeted to develop — this PR was opened against main, which the repo's gate routes through the release train rather than direct PRs. — drafted with Claude Code

@aptracebloc
aptracebloc deleted the fix/2298-correct-tf-docs-claims branch August 24, 2026 09:02
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.

1 participant