docs(commercial): finish the sweep for text aimed at a seller - #192
Merged
Conversation
The rest of the commercial section carried the same fault as #191 in a milder form: pages that speak about the reader in the third person, or that instruct an OpenAdapt seller inside a document the customer reads. - index.md: the resource table told a seller when to send each document ("Introducing the entry offer to a buyer", "Showing a buyer what they will receive"). The column now describes what each document covers. - scope-checklist.md: "Sending this list with the proposal avoids ..." addressed the seller. The page now addresses the customer, and keeps the fact about access that arrives three weeks after signature. - qualification-sprint.md: the page opens with "You bring one named workflow" and then switched to "the customer" for three sections. - execute-api.md: "Mint a production Seal only at tier 2 or 3" instructs a reader who does not mint Seals, and "Do not type a physician password" instructs one who does not type it. Both are now statements about what OpenAdapt does. Dropped "founder-gated", an internal role, from the lane-status sentence. Co-Authored-By: Claude Opus 5 <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.
Follow-up to #191. I read all fifteen pages under
docs/commercial/and checked each one for text addressed to an OpenAdapt seller rather than to the person reading the page. Nothing as blunt as "Do not mix these in one pitch" survived, but four pages carried the milder form.Fixed
index.md. The "Use it when" column described a selling occasion: "Introducing the entry offer to a buyer", "Confirming the customer can actually start", "Showing a buyer what they will receive". A buyer reading that table is not doing any of those things. The column is now "What it covers" and each cell describes the document. Also "how a buyer can qualify" to "how to qualify", and "Qualification Sprint one-pager" to its real name.
scope-checklist.md. "Sending this list with the proposal avoids the most common cause of stalled engagements" is advice to the seller, in the intro of a checklist the customer fills in. The page now addresses the customer and keeps the fact about access arriving three weeks after signature. Two later items moved from "the customer's policies" to "your own policies".
qualification-sprint.md. The page opens "You bring one named workflow. We qualify ..." and then switched to "the customer" for the clock condition, a section heading, and the acceptance criteria. Now consistent.
execute-api.md. "Mint a production Seal only at tier 2 or 3" is an instruction to someone who does not mint Seals, and "Do not type a physician password" is an instruction to someone who does not type it. Both now state what OpenAdapt does, matching the wording used on The Seal and the OEM brief. Removed "founder-gated" from the lane-status sentence; it names an internal role on a partner page. Also cut "The rest of this page is the request, poll, receipt, and webhook contract", which tells the reader what they can already see.
Checked and clean
acceptance-matrix, citrix-external-brief, deployment-boundaries, phi-handling, qualification-report-outline, security-packet, subprocessors, vulnerability-disclosure, and the four pages fixed in #191. These address a buyer, a reviewer, or an integrator throughout.
Checks
mkdocs build --strictis clean andpytest testsis 298 passed.