docs: overhaul README + landing page (toolkit + data engine)#33
Merged
Conversation
…+ data engine) The README and landing page had grown as a flat list of per-dataset features and predated the catalog work. Restructure both around the two things Forge now is: a format toolkit and a data engine. README (487 -> 346 lines): - Three parts: "The format toolkit" (grouped Convert & interop / Score & clean / Understand), "The data engine" (numbered pipeline ingest -> query -> embed -> search -> dedup -> curate -> Studio), and "Reference". - Nav table with jump-links; install leads with `pip install forge-robotics` + an extras table and a note that the data-engine features are newer than the last PyPI tag (install from source for now). - Collapsible <details> for depth (quality metrics, RoboDM); merged the redundant Quick Start / Usage / CLI-reference sections into a 60s taste + a command cheatsheet. All internal links verified. Landing page (docs/index.html): - New "The Data Engine" section (catalog, semantic search, dedup & curation, Forge Studio, cloud-native, idempotent/versioned) using the existing card design system, plus an ingest->...->Studio flow strip. - Hero tagline, <title>/meta, and nav reframed to cover both halves; Features section relabeled as "The Toolkit"; a 4th "Build a corpus" quickstart step. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
The README and the landing page (
docs/index.html) had grown as a flat list of per-dataset features and predated the catalog work entirely. This reframes both around the two things Forge now is: a format toolkit and a data engine.README (487 → 346 lines)
# The format toolkit(grouped into Convert & interop · Score & clean · Understand) →# The data engine(a numbered pipelineingest → query → embed → search → dedup → curate → Studio) →# Reference.pip install forge-robotics+ a compact extras table, and an honest note that the data-engine features (catalog, search, Studio) are newer than the last PyPI tag → install from source for now.<details>for depth (the 8 quality metrics, RoboDM); merged the redundant Quick Start / Usage / CLI Reference sections into a 60-second taste + a command cheatsheet. All 19 internal links verified.Landing page (
docs/index.html, +139 lines)ingest → … → Studioflow strip.<title>/meta description, and nav reframed to cover both halves; the Features section relabeled "The Toolkit"; a 4th "Build a corpus" quickstart step..engine-flowCSS added in-system; tag balance + section order validated.No code changes — docs only.
🤖 Generated with Claude Code