docs: make healthcare-default framing industry-neutral#49
Merged
Conversation
OpenAdapt serves multiple industries (healthcare clinics AND mortgage/ lending, plus others), so healthcare-specific terms used as the GENERAL default case are reframed as industry-neutral, keeping healthcare as one concrete example rather than the implied only vertical. - deploy-on-prem.md: "the clinic machine" -> "the on-prem machine"; "The clinic never auto-updates" -> "The on-prem host never auto-updates"; Citrix section: "the clinic host inside the clinic network" -> "the on-prem host inside your network", "a clinician's session" -> "a user's session", "the EMR" -> "the target application (for example an EMR)", "the local EMR's system-of-record API" -> "the local system-of-record API"; "wrong-patient" -> "wrong-record" (guarantees + identity ladder); "never patient data" -> "never the underlying record data". - identity-gate, troubleshooting, capability-ladder: general-mechanism "wrong-patient" -> "wrong-record" and "two different patients" -> "two different records" (matches the neutral "wrong-record" term the docs already use elsewhere); "medical record number" -> "identifier". - capability-ladder / parameters-and-secrets / record-your-app / induce-a-program: neutralize sole inline "patient" examples to "record". - regulated-execution: "a consequential clinical write" -> "a consequential write" (the clinical-write policy NAME is unchanged). Kept healthcare where it is a legitimate example or real evidence: multi-vertical lists (index.md, security page), the OpenEMR/openIMIS/ Lending qualification evidence, the "WinForms Patient Notes" named test workflow, MRN glyph illustrations, the multi-trace induction worked example, and the clinical-write policy identifier. Left PHI/PII/BAA/HIPAA/ PHIPA lines untouched for the compliance-copy agent. mkdocs build --strict, pytest tests/ (64), and validate_docs.py all green. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NyCHrzA1psrKMFfroYbzaM
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
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
OpenAdapt serves multiple industries (healthcare clinics and mortgage/lending, plus others). This sweep rewrites healthcare-specific terms that were used as the general/default case so the product reads as industry-general, while keeping healthcare as one concrete example (never erasing the domain).
The trigger was
guides/deploy-on-prem.mdheading "What runs on the clinic machine" -- "clinic" is wrong as the general term for the on-prem host.Changes (old -> new)
guides/deploy-on-prem.md
concepts/identity-gate.md, guides/troubleshooting.md, concepts/capability-ladder.md (general-mechanism prose)
concepts/capability-ladder.md, guides/parameters-and-secrets.md, guides/record-your-app.md, guides/induce-a-program.md
concepts/regulated-execution.md
clinical-writepolicy name is unchanged)The docs already used "wrong-record" as the neutral term in several places (security page, substrate-model), so this makes usage consistent.
Healthcare deliberately kept (example vs evidence)
index.md("500th patient referral ... claims batch ... mortgage file"),security-and-data-handling.md("clinics, lenders, and back offices")clinical-writepolicy identifier (a literal CLI value)Validation
pytest tests/-> 64 passed (incl.test_substrate_evidence_copy.py)scripts/validate_docs.py-> Validation passedmkdocs build --strict-> clean (only pre-existing INFO notes)No em dashes added. Coordinated with the concurrent
--url/browser-framing agent (distinct lines indeploy-on-prem.md/run-a-deployment.md).🤖 Generated with Claude Code
https://claude.ai/code/session_01NyCHrzA1psrKMFfroYbzaM