Skip to content

Fix docs themes, code presentation, and evidence page - #288

Merged
NomadDigita merged 23 commits into
mainfrom
fix/docs-theme-code-evidence
Oct 22, 2026
Merged

NomadDigita merged 23 commits into
mainfrom
fix/docs-theme-code-evidence

Conversation

@NomadDigita

Copy link
Copy Markdown
Member

Summary

  • Keep developer docs and evidence surfaces aligned with the selected Tidelight theme.
  • Add visible, accessible copy controls to documentation and package walkthrough code samples, with a consistent higher-contrast code treatment.
  • Replace generic package glyphs with recognizable TypeScript/JavaScript, Python, React, and terminal marks.
  • Reframe evidence page copy as a professional evidence inventory while preserving the manifest’s factual scope and limitations.

Verification

  • Production browser review identified the missing copy actions in developer docs and the hard-coded evidence palette.
  • CI/build and production browser verification pending.

@vercel

vercel Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
tidelight Ready Ready Preview Oct 22, 2026 12:01am UTC

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-22T00:03:56.394637Z ad39e2f PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

.tic-packages-page .tic-package-card{transition:transform .22s,border-color .22s,box-shadow .22s}
.tic-packages-page .tic-package-card:hover{transform:translateY(-3px);border-color:color-mix(in srgb,var(--tic-accent) 38%,var(--tic-line));box-shadow:0 22px 56px color-mix(in srgb,#071d16 11%,transparent),inset 0 1px color-mix(in srgb,#fff 55%,transparent)}

P2 Badge Preserve the reduced-motion override for package cards

For users with prefers-reduced-motion: reduce, the earlier rule at line 189 disables card transitions, but this later and more-specific selector restores a transform transition and the hover rule animates a three-pixel translation. The cascade therefore defeats the repository's reduced-motion handling on every package directory card; move an equally specific reduced-motion override after these rules or omit the transform animation under that preference.

ℹ️ 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".

Comment thread app/evidence/page.tsx
Comment on lines +26 to +27
<p>Review the public artifacts, account-scoped records, and reproducibility criteria associated with Tidelight’s S2 submission.</p>
<div className="evidence-note"><b>Scope</b><span>{manifest.evidence_boundary.note}</span></div>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Restore the explicit evidence disclaimers

This rewrite removes both limitation statements enforced by tests/evidence-manifest.test.mjs: that the index is “not a performance claim” and that the historical report must not be interpreted as positive-alpha evidence. The evidence test now fails at line 20 and would subsequently fail at line 21, blocking CI; retain those explicit disclosures while applying the new presentation.

Useful? React with 👍 / 👎.

Comment thread app/evidence/evidence.css
Comment on lines +1 to +2
.evidence-page{--evidence-accent:var(--brand-teal,var(--mint-2));min-height:100vh;padding:24px clamp(20px,5vw,76px) 64px;background:radial-gradient(circle at 85% 0%,color-mix(in srgb,var(--evidence-accent) 13%,transparent) 0,transparent 33%),var(--bg);color:var(--text)}
.evidence-page a{color:var(--evidence-accent);text-decoration:none}.evidence-page a:hover{text-decoration:underline}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use the theme-specific accent on the evidence page

In Daylight mode, the globally defined --brand-teal (#29c8bb) is selected here, so the --mint-2 fallback is never used; against the Daylight page and panel backgrounds its contrast is only about 1.7–2.1:1. This makes every evidence link, kicker, and default status fail normal-text contrast, whereas the theme-specific Daylight accent is deliberately darker. Set this from the theme token or provide a Daylight override.

Useful? React with 👍 / 👎.

Comment on lines +21 to +22
<button type="button" className="tic-code-copy" onClick={copy} aria-live="polite" aria-label={status === "copied" ? "Code copied" : "Copy code"}>
{status === "copied" ? "Copied" : status === "failed" ? "Copy unavailable" : "Copy code"}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Announce clipboard failures to assistive technology

When navigator.clipboard.writeText rejects—for example because clipboard access is unavailable or denied—the visible text changes to “Copy unavailable,” but the button's aria-label remains “Copy code.” Because that label supplies the accessible name inside the live region, screen-reader users receive no failure state and may believe copying succeeded; include the failed state in the accessible label as well.

Useful? React with 👍 / 👎.

@NomadDigita
NomadDigita merged commit 1219196 into main Oct 22, 2026
11 of 12 checks passed

This branch was successfully deployed

1 active deployment
Preview — 8c8f289d Deployed Oct 22, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant