Skip to content

Stabilize site direction before more page edits #206

@GsCommand

Description

@GsCommand

We are moving across too many surfaces at once. Freeze direct page redesigns until the site is organized into a small execution plan.

Context from audit:

  • Core product funnel: /index.html, /capabilities.html, /how-it-works.html, /verify.html, /docs.html, /quickstart.html
  • Developer docs: /docs/wrap-your-agent.html, /sdk-records.html
  • Protocol/reference: /trust-verification.html, /commons.html, /commercial.html, /agent-cards.html, /runtime.html, /licensing.html, /repositories.html
  • Demo/dev-only: /verify-badge-demo.html, /ambient-verification.html, /demo.html
  • No hard-delete candidates yet. Merge overlaps first.

New rule:
Do not delete pages yet.
Do not redesign random pages out of order.
Do not overwrite full HTML files unless the task explicitly requires a full page rebuild.

Execution order:

  1. Restore capabilities.html to the last full good version and fix only nav if needed.
  2. Lock the global nav labels and logo pattern.
  3. Upgrade verify.html only: move "What gets checked" above verifier panel and convert proof links into a serious Proof Surfaces section.
  4. Upgrade ambient-verification.html only after verify.html is stable.
  5. Create /claim.html scaffold.
  6. Create /agents.html scaffold.
  7. Then revisit remaining reference pages for merge/cleanup.

Acceptance criteria:

  • No PLACEHOLDER text anywhere.
  • No REVERT_TO_PREVIOUS_VERSION_PLACEHOLDER anywhere.
  • No accidental meta refresh pages.
  • Main nav remains stable: Home, Capabilities, Verifier, SDK, Docs, GitHub.
  • Page changes are small and scoped.
  • Run available tests or report if none exist.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions