docs: align DocC, website, and validation with canonical workflow API#26
Conversation
- Update profiling presets in DocC to match source (.power/.ane opt-in) - Add platform-availability notes for TerraTracedSession - Expand legacy-ref validation to cover .attr, .provider, Terra.trace, etc. - Add website/src to doc-snippet scanning - Mirror website page.tsx recipe in compile-checked snippet tests - Fix website install command and hero example to use Terra.workflow - Include PUBLIC-API-COVERAGE.md as source-backed public baseline
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: d828e007cb
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| <div className="flex items-center gap-3 px-6 py-4 rounded-xl bg-white/5 border border-white/10 mono text-sm group cursor-pointer hover:bg-white/10 transition-all"> | ||
| <span className="text-gray-500">$</span> | ||
| <span className="text-cyan-400 font-medium">swift package</span> add terra | ||
| <span className="text-cyan-400 font-medium">swift package</span> add-dependency https://github.com/christopherkarani/Terra.git |
There was a problem hiding this comment.
swift package add-dependency
The new install command shown on the landing page is not executable as written: swift package add-dependency requires a version selector (--from, --exact, --branch, --revision, or --up-to-next-minor-from). I verified this locally with swift package add-dependency --help and by running the exact command in a fresh package, which fails with error: must specify one of --exact, --branch, --revision, --from, or --up-to-next-minor-from. As a result, copy/pasting this onboarding command will fail for all users.
Useful? React with 👍 / 👎.
1 participant
Summary
Aligns public-facing docs, validation scripts, and website copy with the current canonical Terra API surface.
Changes
Verification
Pre-existing issue
惄DocumentationLintTests / Every published cookbook swift snippet has a compile-checked mirror情 is already failing on 惄main情 (README.md has 12 snippets, only 6 mirrored). This PR does not change that ratio.