Skip to content

Contain internal documentation pages - #1104

Closed
aram356 wants to merge 2 commits into
mainfrom
docs-public-containment
Closed

Contain internal documentation pages#1104
aram356 wants to merge 2 commits into
mainfrom
docs-public-containment

Conversation

@aram356

@aram356 aram356 commented Aug 31, 2026

Copy link
Copy Markdown
Collaborator

Scope

  • exclude internal, planning, onboarding, README, and unverified business pages from VitePress output
  • add the Guide landing page and point Guide navigation to it
  • remove Business Value navigation
  • move and scrub maintainer onboarding

No CNAME, package metadata, marketing-copy, or unrelated navigation changes are included.

Verification

Pre-change build leaked these representative artifacts:

  • docs/.vitepress/dist/superpowers/archive/2026-03-19-sequence-design.html
  • docs/.vitepress/dist/internal/EDGEZERO_MIGRATION.html
  • docs/.vitepress/dist/epics/revenue-operations-dashboard.html
  • docs/.vitepress/dist/guide/onboarding.html
  • docs/.vitepress/dist/README.html
  • docs/.vitepress/dist/business-use-cases.html

Passed after the change:

  • npm run lint
  • npm run format
  • npm run build
  • excluded artifact and excluded-href assertions
  • required Home, Guide, and API Reference artifact/content assertions
  • repository-relative onboarding target existence checks
  • git diff --check

External handoff block: PR (b)

  • Handoff ID: (b)
  • Source capture timestamp: 2026-08-31T23:45:45Z
  • Source capture actor: OpenAI Codex controller acting for aram356
  • Source worktree: .claude/worktrees/docs-public-containment
  • Branch: docs-public-containment
  • PR state at creation: open; draft status determined by GitHub response
  • Fresh audited_main_tip: d516a9e94249e10cbc36e41beb4269f9255cf407
  • Exact PR base SHA at creation: d516a9e94249e10cbc36e41beb4269f9255cf407
  • Exact PR head SHA at creation: e6554f24f58f6122fb806ce25432f66033765c65
  • Trusted tool/source SHA: not applicable; candidate executes only repository docs tooling after review
  • Base-controlled controller ref/SHA: not applicable to PR (b)
  • Changed paths/modes: M docs/.vitepress/config.mts; M docs/guide/index.md; D docs/guide/onboarding.md; A docs/internal/onboarding.md
  • Local checks: passed as listed above
  • Hosted checks: pending
  • Ruleset/protection/merge-queue capture: pending authenticated pre-merge capture
  • Live Pages receipt: pending merge and deployment
  • Rollback: retain exclusions and scrubbing; revert only a causal non-security change or redeploy a known-good artifact that preserves containment
  • rc import checkpoint: Task 4, pending

Post-merge fields will be appended after deployment: authenticated final base/head, merge SHA, hosted check runs/apps, live URLs/status/content, response headers, deployment SHA, and ruleset/protection capture.

@aram356
aram356 requested a review from jevansnyc August 31, 2026 23:46
@aram356

aram356 commented Aug 31, 2026

Copy link
Copy Markdown
Collaborator Author

PR (b) pre-merge protection capture

  • Capture ID: pr-b-protection-2026-08-31T23:48:00Z
  • Actor: OpenAI Codex controller acting for aram356
  • Operation: read main branch protection and active main ruleset
  • Commit/ref: d516a9e94249e10cbc36e41beb4269f9255cf407, refs/heads/main
  • Request 1: GET /repos/IABTechLab/trusted-server/branches/main/protection
  • Response: 200
  • Redacted response bytes: 1733
  • Response SHA-256: 2b523d7977b05539e6bd195eaab508045774207e631da84233cd96434517840f
  • Request 2: GET /repos/IABTechLab/trusted-server/rulesets/4270201
  • Response: 200
  • Redacted response bytes: 1666
  • Response SHA-256: b50b837c61b8ad995d88fb8daf7db931eb299cc4b763e7b357714d5ae0aa3a95
  • Interpretation: strict required-status policy is enabled; one approving review is required; required contexts are cargo test, cargo fmt, format-docs, and format-typescript; the active ruleset contains no merge-queue rule, so merge queues are disabled.

Branch-protection response body:

{"url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection","required_status_checks":{"url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/required_status_checks","strict":true,"contexts":[],"contexts_url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/required_status_checks/contexts","checks":[]},"restrictions":{"url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/restrictions","users_url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/restrictions/users","teams_url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/restrictions/teams","apps_url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/restrictions/apps","users":[],"teams":[],"apps":[]},"required_pull_request_reviews":{"url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/required_pull_request_reviews","dismiss_stale_reviews":false,"require_code_owner_reviews":false,"require_last_push_approval":false,"required_approving_review_count":1},"required_signatures":{"url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/required_signatures","enabled":false},"enforce_admins":{"url":"https://api.github.com/repos/IABTechLab/trusted-server/branches/main/protection/enforce_admins","enabled":true},"required_linear_history":{"enabled":false},"allow_force_pushes":{"enabled":false},"allow_deletions":{"enabled":false},"block_creations":{"enabled":true},"required_conversation_resolution":{"enabled":true},"lock_branch":{"enabled":false},"allow_fork_syncing":{"enabled":false}}

Active main-ruleset response body:

{"id":4270201,"name":"main","target":"branch","source_type":"Repository","source":"IABTechLab/trusted-server","enforcement":"active","conditions":{"ref_name":{"exclude":[],"include":["~DEFAULT_BRANCH"]}},"rules":[{"type":"deletion"},{"type":"non_fast_forward"},{"type":"required_signatures"},{"type":"pull_request","parameters":{"required_approving_review_count":1,"dismiss_stale_reviews_on_push":false,"required_reviewers":[],"require_code_owner_review":true,"dismissal_restriction":{"enabled":false,"allowed_actors":[]},"require_last_push_approval":false,"required_review_thread_resolution":false,"require_extra_approval_for_unattributed_changes":true,"allowed_merge_methods":["merge","squash","rebase"]}},{"type":"required_linear_history"},{"type":"required_status_checks","parameters":{"strict_required_status_checks_policy":true,"do_not_enforce_on_create":false,"required_status_checks":[{"context":"cargo test","integration_id":15368},{"context":"cargo fmt","integration_id":15368},{"context":"format-docs","integration_id":15368},{"context":"format-typescript","integration_id":15368}]}},{"type":"code_quality","parameters":{"severity":"errors"}}],"node_id":"RRS_lACqUmVwb3NpdG9yec44rPxqzgBBKHk","created_at":"2025-03-20T05:05:23.918-07:00","updated_at":"2026-03-05T09:59:05.425-08:00","bypass_actors":[{"actor_id":null,"actor_type":"OrganizationAdmin","bypass_mode":"always"},{"actor_id":5,"actor_type":"RepositoryRole","bypass_mode":"always"}],"current_user_can_bypass":"always","_links":{"self":{"href":"https://api.github.com/repos/IABTechLab/trusted-server/rulesets/4270201"},"html":{"href":"https://github.com/IABTechLab/trusted-server/rules/4270201"}}}

@aram356

aram356 commented Sep 1, 2026

Copy link
Copy Markdown
Collaborator Author

Superseded by the approved single-PR delivery model. All documentation-refresh implementation will be committed to #1049; this branch remains intact until its reviewed commits are transferred.

@aram356 aram356 closed this Sep 1, 2026
@aram356
aram356 removed the request for review from jevansnyc September 1, 2026 01:09
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