GitHub links
GitHub links
Breadcrumbs

Engineering QBR / Stakeholder page

Run a quarterly business review or stakeholder update from a single Confluence page where delivery metrics are always current - no manual exports, no screenshots, no stale data.

Why it works

  • Macros render live from GitHub on each page load - metrics are current whenever someone opens the page

  • Delivery signals sit alongside written narrative in one place

  • Team-level framing keeps the focus on patterns and trends, not individuals

  • No code or PR data is stored; metrics reuse your existing GitHub connection

Build it

Step 1: Create the page
Create a new page titled something like Engineering QBR - Q[X] [Year] under your team space.

Step 2: Add delivery metrics
Add the following macros in sequence, using the same repositories and date range across all three for consistency:

  1. Type /PR Throughput - configure with your team repositories and the quarter date range. This sets the volume context.

  2. Type /PR Cycle Time - same scope. This shows whether delivery speed improved or slowed during the quarter.

  3. Type /Review Latency - same scope. This surfaces any review-capacity bottlenecks.

Use Full (KPI + chart) display for each macro to show both the summary statistic and the trend over the quarter.

Step 3: Add narrative
Between or below the macros, add sections for:

  • Highlights - what the team shipped

  • Risks and blockers - what slowed delivery

  • Next quarter focus

Step 4: Publish and share
Publish the page and share the link. Stakeholders see live metrics each time they open it - no updates needed between sessions.

Tips

  • Set the same date range on all three macros. Mixed ranges on the same page can mislead.

  • Use the Compare to previous period option (enabled by default) to give stakeholders immediate trend context without extra explanation.

  • For recurring QBRs, duplicate the previous quarter's page and update the date range - the macros recalculate automatically.

  • The Compact (KPI tile) display works well if you want to arrange metrics side by side in a Confluence layout column.

Updated: