Skip to main content

Reviewer Guide

Purpose​

Provide a concise, reviewer-first path to validate the portfolio quickly while keeping links to deeper evidence.

Scope​

In scope​

  • Portfolio App overview and evidence links
  • Documentation App dossier and governance artifacts
  • Testing, security, and operations evidence

Out of scope​

  • Deep feature walkthroughs
  • Implementation detail beyond evidence validation

Prereqs / Inputs​

  • Access to the Portfolio App and Documentation App
  • A modern browser

Procedure / Content​

Fast path (10–15 minutes)​

  1. Portfolio App overview

    • Visit the homepage and skim the reviewer callout.
    • Open the CV: /cv for scope and seniority signals.

  2. Project evidence

    • Open the Portfolio App project page: /projects/portfolio-app.
    • Follow evidence links to dossier, ADRs, and runbooks.

  3. Dossier validation

  4. Security & operations

  5. Testing & CI evidence

  6. Governance policies

Validation / Expected outcomes​

  • The portfolio narrative aligns with documented evidence.
  • Evidence links resolve and are current.
  • CI/testing posture is explicit and verifiable.

Failure modes / Troubleshooting​

  • Links fail: check for doc path drift or build errors.
  • Claims unverified: consult the evidence audit checklist.

References​