Repository navigation
docs: polish the measurement and dashboard pages (audit 2/5) - #854
Draft
hongyi-chen wants to merge 9 commits into
Draft
hongyi-chen wants to merge 9 commits into
hongyi-chen wants to merge 9 commits into
Conversation
Reshape the factories overview from a launch-post structure into a technical overview: a concrete definition up front, one short section per part of a factory, sizing guidance, and related pages. Removes the "Who benefits", "What you get", product-table, and "Key terms" sections and the undefined "delivery policy" coinage. The #sizing-a-factory anchor that three pages link to is preserved. Aligns the opening definition on how-factories-work and the docs homepage with the overview, trims the diagram legend, cuts the salesy self-improvement framing, and adds the missing Related pages section. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
…w-copy # Conflicts: # src/content/docs/factories/how-factories-work.mdx # src/content/docs/factories/index.mdx # src/content/docs/index.mdx
Tighten the opening (drop "tools your team already uses"), make the component headings parallel, say "repeated failures" consistently, and note that benchmarks now compare harnesses as well as models and runners per #841. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
Add Microsoft Teams and Azure DevOps to the how-factories-work work sources legend so it matches the overview, and drop the restated consequence clause from the overview's Execution section in favor of naming what the infrastructure page covers. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
Same treatment as the factories overview: a concrete opener, three short lists of what Enterprise adds (administration, security and compliance, shared team configuration), role-based entry points, and related pages. Removes the "Who Warp Enterprise is for", "What this section covers", "Why enterprises choose Warp", and "Support and resources" sections and the marketing adjectives. Every retained claim was checked against the enterprise page it links to. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
This reverts commit ff03ffb.
Shorten the lead to two sentences, keep the CTA cards directly under it, and open a "What a factory does" section for the foreman, example, and human-checkpoint detail so the body is not an unbroken block of prose before the first H2. Rewrite the description so it stops repeating the lead paragraph it renders next to. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
Part 2 of 5 of the Warp Factories docs audit, split out of #852. Co-Authored-By: Warp <agent@warp.dev>
Collaborator
Author
|
This PR was generated with Warp. Comment   |
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This branch was successfully deployed
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.
Summary
Part 2 of 5 of the Warp Factories docs audit (split out of #852). Documents the default Scorers, gives the dashboard metric definitions one home, and fixes the formatting on the benchmarks page.
Changes
measure-and-improve/scorers.mdxmeasure-and-improve.mdxfactory-dashboard.mdxcarried move into the table here.factory-dashboard.mdxmeasure-and-improve.mdxinstead of repeating the definitions.benchmarks.mdxfactory-inbox.mdxandself-improvement.mdxContent design plan
Audience and JTBD: Someone reading dashboard numbers or setting up evaluation for the first time.
Problem: Default Scorers were undocumented, and the metric definitions lived in two places that had already started to diverge.
Goals: One definition per metric; the defaults are visible before the reader creates anything.
Content type: Existing feature and conceptual pages; no new pages.
Unverified claims
None.
Documentation risk
Risk: engineering-review-required
Rationale: Adds the default Scorer set and its sampling rate as product claims; the rest moves or rewords existing content.
Source files consulted: warp-server/logic/factorysource/defaults/scorers.go@cf7e9149d422
Engineering review status: pending
Docs override: none
Validation
npm run build,check_links.py --internal-only(0 broken), andstyle_lint.pywere run on the combined audit branch that these files were split from.Plans:
Co-Authored-By: Warp agent@warp.dev